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は じ め に 

はじめに 

この度 は， MSX-C Ver.1.2 をお 求め 下さいまして ありがとう ございます. 

MSX-C Ver.1.2 は C 言語で かかれた ソース プログラム を 処理し， アセンブラ • ソース プロ グラ 
ムを 生成す る コンパイラです， 

新たに， MSX-DOS バージョン 2 を サポート する ことにより， 漢字の メッセージ を 表示した 
り， 漢字の データ を 処理したり， 階層 ディレクトリ などの 機能 を 使用す る ことができます. その 
ため， 標準 ライブラリが 強化され， いっそう 使いやすく なって います. 

なお， 本 ソフトウェアに は MSX-D0S2, スクリーン エディ タ， MSX'M-80， MSX-L-80, LIB 
-80, CREF-80 は 含まれて おりません， MSX-C Ver 丄 2 を 使用して プログラム 開発 を 行なう 場合 
に は これらの ソフ トウ エアが 必要と なります ので， お持ちで ない 方 は r MSX-DOS2 TOOLSj 
をお 買い求め 下さい. また， プログラム 開発 を 行なう 上で デバッグ を 効率的に 行なうた めに， MSX 
用 シンポ リ ッ ク デバ ッ ガ 「MSX-S BUG2」 が, ライブラリ パッ ケージ と して 「MSX-C Libraryj 
が それぞれ 別売に て 用意され ています. 

本 ソフトウェア を ご 使用になる 前に， 添付の 「ソフト ゥヱァ 使用 承諾 契約書」 をよ くお 読みい 
ただき， ご 確認のう え， 添付の ユーザ一 登録 カードに ご 記入し， 弊社まで ご 返送 下さい. ご 返送 
を もつ て 承諾 契約書に ご 同意いた だいた ものと いたします. 

この 「ユーザー 登録 カード」 を ご 返送いた だけない 場合に は， 弊社と いたしまして は 所定の ァ 
フタ 一 サービス をいた しかね ますので， よろしく ご了承の ほどお 願い 申し上げます. 

本パ ッ ケージ に は 以下の も のが 含 まれて います. 

■ MSX-C Ver.1.2 システム ディスク 1 枚 

(3.5-1DD フロッピ一 ディスク） 

■ MSX-C Ver.1.2 ユーザーズ マニュアル 1 冊 



■CS3， MSX-DOS2, MSX-M-80, MSX-L-80, MSX- C は アスキーの 商標です. 

■ MS-DOS は 米国 マイ ク ロソフ ト 社の 商標です. 

■ Z80 は Zilog. Inc. の 商標です. 

■ UNIX オペレーティングシステム は 米国 AT&T の ベル 研究所が 開発し， AT&T が ライセンス 
しています. 



ご注意 



(1) この ソフトウェア ならびに マニュアル を 賃貸 業に 使用す る こと を 禁じます. また， この ソフト 
ウェア や マニュアルの 一部 または 全部 を 無断で コ ピーす る こと はでき ません. 

(2) この ソ フ トウ ヱ ァは， 個人 使用 以外の 目的で コ ピーす る こと はでき ません. 

(3) この マニュアルに 記載され ている 事柄 は， 将来 予告な く 変更す る ことがあり ますが， 当社に 登 
録 されて いる 方に は 案内 をお 送りし ます. 

(4) 製品の 内容に ついては 万全 を 期して おります 力、 製品の 内容に ついての ご 不審 や， 誤り， マ 二 
ュ アルの 記載 もれな ど， お気付きの ことが ございましたら， マニュアルの 巻末の 「お問い 合わ 
せ」 についての 要領で お送り 下さい. 



(5) この ソフト ゥヱァ を 運用した 結果の 影響に ついては， （4) 項に かかわらず， 責任 を 負い かねます 
ので ご了承 下さい. 

(6) この ソフ トウ エアの 運用 は 個人 使用に 限り ます. この ソフ トウ エア を 使用して 開発した プ ログ 
ラム を 販売 • 頒布す る 場合 は， 弊社と 使用 許諾 契約 を 結んで いただきます. 

使用 許諾 契約に 関す る お問い合わせ は 

株式会社 アスキー MSX 推進 部 

TEL. 03-486-8346 (祝祭 日 を 除く 月 〜金） 

10 ： 00—12 ： 00, 13 ： 00〜17 ： 00 

までお 願いいた します. 
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序章 本 マニュアルの 構成 

本 マニュアル は， 以下の 3 点に 留意して 書かれて います. 

(1) C 言語に 初めて 接する ユーザー 力、 抵抗な く C 言語の 世界に 入り， MSX-C コンパイラ を 使 
いこ なすこと を 可能に する. 

(2) 本格的な プログラムの 開発の ツールと して MSX-C コンパイラ をお 使いになる ユーザーが， 
その 処理 系の 特徴 を 把握し， すぐに 実用で きる ようにす る. 

(3) 必要な ときに すぐ に 項目 を 参照で きる よう な 構成 とする. 

また， 操作 方法に ついては サンプル プログラム を 用いて 初学者に も 分かりやすく 解説して いま 
す. さらに， 処理 系と しての MSX-C コンパイラの 特徴， 標準 的な C との コーディング 上の 違い 
など を， ひとつの 章に まとめて 解説して あります. 

さらに， 標準 ライ ブラ リ 関数 や 各 コマンドの パラメータ が 即座に 参照で きる よう に 独立 し た 章 
を 設け， リファレンス マニュアル としてお 使い 頂ける ようになつ ています. 

本 マニュアル は， 始めから 順次 読み進む ことによって 初学者の 方で も MSX-C コンパイラ を理 
解で きる よう に 章 組 を 工夫 しています. 他の 処理 系 による C 言語 をお 使い になつ た 経験の ある 方 
は， 必要な 箇所の み を 随時 ご 参照 下さい. 

以下に 本 マニュアルの 第 1 章 以降の 概略 を 示 します. 

第 1 章 MSX- C コ ンパ イラの 概要 

本章で は， MSX-C コンパイラの 概要 を 述べる と共に， 開発 環境の 構築 方法， ソースファイルの 
作成 か ら プログラム の 実行 ま での 流れの 概説， さ ら に 付属の サ ン プル プログラムに ついても 解説 
します. C 言語 を はじめて 学習され る 方 は 是非 本章から お読み下さい. 

第 2 章 MSX-C コンパイラの 操作 

サンプル プログラム を 実際に コンパイルしながら， MSX-C コンパ ィ ラの各 コマンド 操作 を 習 
得して いきます. 

第 3 章 MSX - C による プログラミング 

標準 的な C 言語の 処理 系で ある V7 UNIX-C と の 言語 仕様 上の 相違点 を はじめと して， 
MSX- C 独自の 処理に よる オブジェ ク ト 効率の 向上 や， アセンブリ 言語との リ ンクの 方法 等 
MSX-C による プロ ダラ ムの 開発に 不可欠 な 知識 を 解説 します. 
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第 4 車 MSX-C 標準 ライブラリ 

MSX- C の 標準 ライブラリ ルーチンの 概要， V7 UN1X-C の ライブラリとの 違い， さらに ユー 
ザ一 独自の ライブラリ 作成 及び， 保守の 方法 についても 本章で 解説 します. 

第 5 章 MSX-C コンパイラの 応用 

MSX-C の 応用 例 として MSX-DOS 以外の 環境で 実行す る プログラム 開発の 実際 を 示 します. 

(1) BASIC 環境 下の マ シ ン語 サブルーチンの 作成 

(2) ROM 化 プログラムの 作成 

第 6 章 標準 ライブラリ 関数 リファレンス 

付属す る 標準 ライブラリ 関数 を ひとつず つ 解説し ます. また 使用例 を あげ 分かりやすく， 関数 
の 細か い 部分 ま で 説明 してあります. 

第 7 章 コマンド リファレンス 

各 コマンドの パラ メータ 及び それぞれの 機能が 表 形式で 参照で き ま す. 

第 8 章 エラーメッセージ ー覽 

各 コマンドが 表示す る エラー メ ッ セージ を コマンド ごとに 説明して あります. 

第 9 章 標準 ライブラリ 閲数ー JI 

標準 ライブラリ 関数の 一覧 を 関数の 分野 別に 表に しています. 第 6 章の リファレンスの ページ 
も 表に 含まれて います， 

第 10 車 サンプル プログラム q.com について 

MSX-C を 使用して 作成した プログラム q.com について 説明し ます. 

第 11 車 MSX-CVer.1.2 マスター ディスク 内容 

MSX-C コ ン パイ ラ Ver.1.2 に 付属して く る ディスクの 内容の 一覧です. 使用す る 前にで きる 
だけ ご 確認 下さい. 
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1 , 1 MSX-C コンパイラの 概要 



1.1.1 MSX-C コンパイラ 

MSX - C コンパイラ Ver.l.2( 以下， MSX-C と 呼ぶ） は， MSX-DOS バージョン 2( 以下， MSX 
-D0S2) 上で 動作し， ザ イロ グ' ニー モニックの アセンブル' ソース プログラム を 出力す る 2 バ 
スの C 言語 コンパイラです. MSX-DOS バージョン 1 (以下， MSX-D0S1) では 動作し ません. 

コンパイラ を 構成す るの は CF 及び CG という プログラムです， CF (フロント 'エンド） はコ 
ン パイ ラの第 1 パスで， C 言語で 記述され た ソース プログラム を 読み込み， 文法 上， 意味 上の エラ 
—を チェック し 中間 言語 フ アイ ル （T- code と 呼ばれる） を ディ スク 上に 作り ます. この 中間 言語 
フ アイ ルを 読み込み アセンブリ 言語の ソース フ アイ ルに 変換す るの がコ ン パイ ラ の 第 2 パスで あ 
る CG (コード ジェネレータ） です. 

さらに 本 パッケージに は， CF の 出力す る 中間 言語 ファイル を 読み込み， 各 関数に わたされる バ 
ラ メータが その 関数の 定義と 一致して いるか どうか を チェック する プログラム FPC, ユーザー 自 
身に よる 標準 ライ ブラ リル一 チンの 作成 を サポート する プログラム MX などに よ り， プログラム 
の 開発 効率 を 高めて います. 

1.1.2 MSX-C の 棚 

MSX-C の 最大の 特徴 は， そ の 生成す る オブジェクト • コード が 従来の ァ セン ブ リ 言語に よる プ 
ログ ラムに 匹敵す る コンパクトで 効率 性に 富んだ ものである という 点です. これにより， 元来 ァ 
セン プリ 言語 以外での プログラムが 困難であった システム プログラム や， ROM 化 プログラムの 

C 言語に よ る 開発が 可能 となつ たのです. 

さて， MSX-C では， このように 高い コー ド 効率 を 得る ために いくつかの 新手 法が 取り入れられ 
ています. なかで も 変数の 自動 レジスタ 割付と いう 手法 を とりいれ たこと は， マイクロ 'コンビ 
ユー タ 用の コンパイラ として は 画期的な 試みで あり， オブジェクト • コードの 質 を 大きく 向上す 
る ことに 成功して います， 

変数が CPU の レジスタに その 値 を 持って いれば， メモリ 上に あって 演算の たびに メモリに ァ 
クセス する よりも はるかに 効率が よい わけです. しかし， 標準 的な C コンパイラ では プログラマ 
が どの 変数 を レジスタ に 割 り 付ける のが 最 も 効率的 か を 判断 し， これ を 宣言 子 register により 宣 
言して いました. 

これ は， プログラマに とって， 手間の かかる 作業で ある わけです が， そもそも 8080, Z80 とい 
つた 8 ビッ トの CPU を 搭載した マシン 上の コンパ ィ ラ では， レジスタの 数な どの 制限に よ り， 
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register 宣言と いう 手法 を 取り入れる ことができ ま せんでした. 

MSX-C の コード 'ジェネレータ は 最適な レジスタ 割付 を 自動的に 行って くれ， ユーザー は 特に 
これ を 意識す る 必要がない わけです. 

さらに は， バイ ト （8 ビッ ト） 算術 演算の サポート， 関数の 引数の レジスタ 渡し， 非 再帰 モード 
の 導入な ど， より 効率の よい コード 生成 を 目指し， 新手 法が ふんだんに 盛り込まれて いるので す, 

以下に， MSX-C による コ ン パイ ル 結果の 一例 を 示 します. 

サブルーチン toupper () は， 弓 I 数と して 与えられた 1 文字 力、 アルファベットの 小文字なら 大 
文字に 置き換えて， 関数の 値と して 返す ルーチンです * toupper .c を コンパイルした 結果， 生成 さ 
れた アセンブラ' ソースが toupper.mac です. 

変数 c が メモリ 上に でな く 常に A レジスタに 置かれ， 8 ビット （char 型） の 値が 16 ビッ トに拡 
張され ずに 8 ビッ 卜の ままで 演算され ている 様子が よく わかる でしよう. 

TOUPPER. C: 
1* char toupper(c; 
2： ch&r c; 

3： { 

4： if('a， <= c c <= 

5" return (c + 

6： else 
7： return (c); 

8： } 

TOUPPER. MAC: 

1： 



2： 


； MSX-C ver 1.20x 


(code generate 


3： 










cseg 






5： 








6： 


toupperO: 






7： 


CP 


97 


C97 = "a" 


8： 


ret 


c 




9： 


CP 


123 


0123 = "z" + l 


10： 


ret 


nc 




11： 


sub 


32 


032 = "a，， 一， , A" 


12： 


ret 






13： 








14： 








15： 


public 


toupperO 




16： 








17： 


end 







'z') 

'A， 一 ，a，）; 
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第 1裹 MSX-C コンパイラの 概要 

1-1-3 <W カーネルの B 機能 

本節で は， MSX-C の 標準 カーネルで サポート される 機能 を 解説し ます. カーネルと は， MSX 
-DOS が プログラム を 起動す る ときに その プログラムに 渡される 情報 を， C の 環境に 合わせる プ 
ログ ラムの こと をい います， つまり， コマンドの 引数 を 解析して 分割したり， 標準 入出力 フ アイ 
ルを オープン するな どの 作業 をし ます. カーネルが ある ことで， MSX-DOS の インターフェース 
と UNIX のィ ンタ 一フェースの 違い を 吸収で きている わけです. 標準 カーネル は 標準 ライ ブラ リ 
と 一緒に リンク されます. 



A) 引数 （アーギュメント， argument) 

コマンドの 引数 は 空白 （スペース や タブ） で 区切って 渡します. 弓 | 数に 空白， "にや"〉" など 
を 含めたい 場合に は， ダブル クォーテーションマーク （"） で 引数 全体 を 囲んで ください. "が 
はずされた ものが 引数と して 渡されます. また， ダブル クォーテーションマークの 内側で は 以下 
の もの を 1 文字と して 扱います. 

¥n 改行 文字 （¥n) 
¥r 復帰 文字 （¥r) 

，"， ひとつの ダブル クォーテーションマーク （ ，， ） 

解析， 分解され た 各 引数 は 関数 main () の 第 2 引数に， 各 引数への ポインタの 配列と して 渡さ 
れ ます. main () の 第 1 引数 は 整数で， （その 引数の 数 +1) を 示して います. 普通 は 次のように パ 
ラ メータ を 受け取ります， 

nain(argc, argv) 
int argc; 
char *argvt]; 
{ 

} 

argv [0] に は UNIX の 標準 C と 同じ様に MSX- C でも コマンド 名が 渡されます. コマンド 名 
は フルパス 名 （ドライブ， バス， ファイル 名， 拡張 子 すべてが そろった ファイル 名の こと） で 渡 
されます. しかし， COMMAND2 . COM や ver . 1 . 2 の 標準 ライブラリ 以外の プログラム によって 
コマンド が 起動され た 場合に は argv [0] に はヌ ル 文字列 や， 異なった コ マン ド 名が 渡される こ と 
があります. 

コマンド に対する 引数 は argv [1] 以降に 渡されます. 引数の 終わりと して， 最後の 引数の 次 
(argv targe]) に は NULL カミ 代入され ています. 引数 は 環境 変数 UPPER の 値に よらずに 大文 
字， 小文字の 区別が 保存され ます. 
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主意 i 

環境 変数 UPPER について は MSX-D0S2 リファレンス マニュアル 81 ページ 「Chapter7 環 
境 変数」 を 参照して 下さい. 



「例 I 

A>a:¥bin¥dunp /n/slOO nsxdos2.sys coffloand2.con @ 

コマンド ライ ン から 上の ように コマンド を 起動す ると main () への 引数 は 次のように なり ま 
す. 



argc 4 

argv [0] "A ： ¥BIN¥DUMRCOM" 

argv [1] ，，/n/sl00" 

argv [2] "msxdos2.sys" 

argv [3] '，commarud2，com，， 

argv [4] NULL 



b)«» 入出力 ファイルの 麵り 当て 

UNIX の 環境で は， プログラムが 起動され ると 5 つの 標準 入出力 ファイル （高水準 入出力） が 
オープンされ ています. MSX-C でも 同じ様に stdin, stdout, stderr, stdaux, stdprn が 才一プ 
ン されて います. それぞれの 入出力 方向 は stdin は 入力， その他 は 出力 だけが できます. stderr, 
stdaux は 標準 C では 入力， 出力 と も に 可能です が， MSX-C の 標準 ライ ブラ リ では 構造 上 実現で 
きないので， 片方 向 （この場合 は 出力の み） になって います. バッファリングの 方法 は， stdin, 
stdout, stdprn は 行 バッファリング， stderr, stdaux は バッファリング なしにな つてい ます. フ 
アイ ルに リダイレクトされ ている ときには， フル バッファリングと なります. バッファリングの 
詳細に ついては 「4.3.1 B) 高水準 入出力 関数の バッファリング」 を 参照して 下さい. 



R 主意 1 

ファイルの リ ダイ レク ト はコ マン ドレ ベルで は stdin と stdout しかで きません. 
低水準 入出力 関数 （ファイル ハンドル による アクセス） であれば stderr, stdaux は 入出力 両方 
可能です. 
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第 1 章 MSX-C コンパイラの 概要 



1 -2 ソース フ アイ M) 作成から プログラムの 実 微 で 

前節で MSX-C の 概要と その 8 ビット コンパイラと しての 特徴の 一部 を 述べ ま したが， C 言語 
による プログラムの 開発 を 実際に 行う に は C コンパ ィ ラ だけで は 十分ではありません. C 言語 ソ 
一 スフ アイ ルを 作成す る に はェ デ イタ が 必要です し， C コンパイラ が 生成 して くれる のはァ セン 
プリ 言語の ソースファイル であり， これ を マシン 語に 翻訳して くれる アセンブラ も 必要でしょう 

(ハンド • アセンブル という 手 も ある） • 

本節で は， ソースファイルの 作成から 実行可能な プログラムの 生成までの 手順 を 追いながら， 
MSX-C を 用いての プログラム 開発 環境に ついて 述べて いきます. 

エディタ 

C 言語に よる プログラムの 開発の 第一歩 は， C 言語 ソース プログラム を 作成す る ことです. ここ 
で 必要と なる のが エディタです. （24 ページの 図の (1)) 

実際の 開発で は 試行錯誤 を 繰り返しながら プログラム を 完成 させて いく 場合が 多く ソ一 スフ ァ 
ィル にも 何度も 手 を 加える ことになります. そうなる と， 豊富な ファイル 編集機能 を 備えた 使い 
易い エディタ が 必要 となって きます. 

現在 MSX-D0S2 上で 使用可能な エディタに は 『MSX-D0S2 TOOLSJ の パッケ-ジに 付属の 
スクリーン エディタ などが あります. 

MSX-C では， C 言語の ソースファイルの ファイル 名 拡張 子 は. c を 用いる こと をお 薦めし ま 
す. 他の 拡張 子 を 使用す る こと も 可能です が， コンパイル 時に その 拡張 子 を 含めて ファイル を 指 
定 する 必要が あります. つまり， コンパイラ は ファイル 名に 拡張 子がない と. c を 暗黙 的に フ アイ 
ルの 拡張 子 として その ファイル を コンパイル します. ' 

1-g-g CS 語 ソースから アセンブラ リースへ 

ソ一 スフ アイ ルが 作成で きた ら次 は， コ ン パイ ラ の 出番です. MSX- C では コ ン パイ ルの 作業 を 
2 段階に 分けて 行う こと は 1.1.1 のとお りです が， 第 1 パスで ソースファイルの 文法 上の 間違い 
が 発見され た 場合 は， 再び エディタに 戻って ファイル を 変更し なければ なりません. そして 再度 
CF にかけ ると いう 作業 を 繰り返します. （24 ページの 図の (II)) 

CF を エラーな く 終了す ると ディ ス ク 上に 中間 言語 フ ァ ィ ルが 作られます. こ の 中間 言語 フ ァ 
ィルは 拡張 子. tco を 持ちます. 

こ の 中間 言語 フ アイ ルをコ ン バイ ラの第 2 の パス であ る CG にか ける ことにより， Z80 ニー モ 
ニックに よる アセンブラ • ゾース ファイルに 変換され，. mac という 拡張 子で ディスク 上に セーブ 
されます. （24 ページの 図の （IV)) 
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i ,e,3 実行可能 プログラムの 生成 （アセンブル， リンクの 意 き） 

以上で C コンパ ィ ラの 本体で ある ふたつの パス を 終了し ま した. 生成され た アセンブラ ソース 

は， アセンブリ 言語に 精通した プログラマの 書いた ものに 引け を 取らない 程の 質の 高い ものです 
(勿論， コンパイラの 生成した アセンブラ プログラム 固有の くせ は あるので すが)， 
アセンブル という 作業 を 一口に 言う と， アセンブラ' ソース 中の 各 命令 （ニー モニック + オペ 

ランド） から， それと 等価な マシン 語 (CPU が 理解， 実行で きる 命令) への 置き換えです. （24 ぺ 
ージの 図の （V)) 

例えば， 俗に言う ハンド' アセンブル という 作業で は， ジャンプ 命令の 飛び 先 や CALL 命令に 
よ り 呼び出される サブルーチンの ァ ドレス を 計算し， アセンブラの 二一 モニック や ラベル を 一つ 
ずつ マシン • コード， 実 アドレスに 置き換えて いくのです. 

同様の 作業 を ハンド • アセンブルに 代わって 行う の 力、 アセンブラ 及び リンカです. MSX- DOS 
上で 動作す る アセンブラ に MSX • M80, リンカに MSX • L80 が あ ります. 

MSX-M80 は， Z80 または， 8080 の ニー モニック による アセンブラ • ソースファイル を 読み込 
んでリ ロケータ ブル • オブジェクト • ファイル （ファイル 名 拡張 子. rel を 持つ） に 変換し ます. 

リ ロケータ ブル • ファイル では， アセンブラの ニー モニック は マシン コードに 置き換えられて 
いるので すが， この 段階で は その プログラムが メモリの どの ァ ドレスに 置かれる のかが 不確定で 
あり， 従って ジャンプ 命令の 飛び 先 アドレス など は， 相対的に しか 定まりません. また， ライブ 
ラリ 関数な ど 外部の サブルーチン は， その 名前が 与えられ ている だけな ので， CALL 命令の 呼び 
先の ァ ドレス も 定まって いないの です. 

言い替えれば， リ ロケータ ブル' オブジェクト は， ロード 開始 アドレス を 与える ことにより ど 
のァ ドレスに でも 置く ことができ， また その プログラム 中で 呼び出される 外部の サブルーチン を， 
名前 さえ 同一に してお けば， 自由に すげ 替える ことができる わけです. 

ここまでの 作業で ユーザーが 作成した リ ロケ一 タブ ル' オブジェクト 'ファイル， 外部 ルー チ 
ンの 集合で ある ライ ブラ リ （これ も. rel ファイル である）， メモリの どの ァ ドレスから ロード 実行 
す る か 等の 情報 を MSX.L80 に 渡す ことにより， アド レスが 定ま り 実行可能な プロ グラムと なり 
ます. （24 ページの 図の (VI)) L80 は， 与えられた バラ メータに より， プログラム 中の ジャンプ， 
コールな どの 命令に 実際の アドレス を 与え， ライブラリ • ファイルの 中から ユーザー 'プロ ダラ 
ム 中で 使われて いる 関数 だけ を 抜き出して， これ を 結合して くれる わけです. 
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m^: msx-c コンバ イラの 概要 



1.3 msx-c の鬮発 aw (鬮発 aw の 構築） 

前節で 述べた とおり， C 言語に よる プログラムの 開発に は 本 パッケージに 含まれる プログラム 
の 他に も 様々 な 道具が 必要です. 付属の フロッピ一 ディスク は， 1DD なので あまり 容量がない う 
えに， ライブラリの ノース や サンプル • プログラムの ソース 等が 含まれて いるた め， ユーザー' 
プログラム を 作成す る スペースが 十分と は 言えません. そこで， 付属の ディスクから MSX - D0S2 
の システムの 入った ディスクに 通常の 開発に 必要な ファイル だけ をコ ピーし， 更に アセンブラ， 
リ ンカ， エディ タ などの ユー ティ リ ティ を まとめた システム ディスク を 作成す るの がよ いでし よ 

0. 

以下に， MSX-C コンパイラ を 中心とした 開発 用の ディスクの 作成 例 を 示します. この 例 は， 
MSX-C コンパイラ に付厲 する バ ツチ ファイル mksys.bat (ディレクトリ ¥batch にあります） を 
実行す る と 構築され る 環境です. MKSYS の 使用方法 を 説明し まし よ う. 

U) 新しい ディスク を フォー マツ ト します. 

(2) フォーマット された ディスクに mksys.bat を コピーし ます. MSX-C の マスター ディスクが 
B ドライブに あると すると， 次のようになります. 

A>copy b:¥batch¥iaksys.bat 

(3) コ ピーした ディスク を A ドライブ にいれ， 次のように コマンド を 入力し ます. 

A>mksys b QfJ 

(4) あと は プロンプトに 合わせて， MSX-D0S2 の システム ディスク など を B ドライブに 入れ ま 
す. 

以上で ルート ディ レク ト リで 作業す るた めの ディスクが できます. 2 ドライ ブ シミュレータ を 使 
つてい る 場合に は， "Insert disk 化 r drive <d> ： "という メ ッ セージが 出てから ディスク を 交換 
して 下さい. 

ルート ディレクトリ で 作業す る ディスク が 出来上が り まし たが， ま だ 環境 （墚境 変数） が 整 つ 
ていません. MKSYS コマンドの 最後に も 表示され るよう に， ソースファイルの エディット， コ 
ン パイル をす る 前に CENV を 実行し なければ な りません. MKSYS で 出来上がった ディスクが 
A ドライブに あるなら， 次のように します. 

A>cenv a レ刁 
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CENV の 引数に は， MKSYS で 作成され た ディスク を; Ux る ドライブの， ドライブ 名 （B ドライ 
ブ なら" b" の 1 文字) だけ を 指定し ます. バッチ コマンドの 実行が 終れば， 環境 変数 も 設定され て 
います. CENV は 一度 電源を切って しまう と， もう 一度 実行し なければ なりません. MSX-C を 
使う とき に 必ず 必要な コマ ン ド ですから， MSX-D0S2 立ち上げ ディ スクの autoexec.bat に 同じ 
内容 を 入れて お く のがい いでしょう. 

出来上が つた ディスクに は 次の ような ファイル が 入 つてい る はずです. （ A ドライブに デ イス 
クが あると します.） 

a:¥ (ルート ディ レク ト リの 内容） 



mksys.bat MSX-C の ディ ス ク 作成 用 バッチ ファ ィ ル 

msxdos2 ， sys MSX-D0S2 システム ファイル 

command2.com 〃 

ck.rel ライブラリ ファイル 

clib.rel ガ 

crun.rel ,， 

cend.rel 〃 

c.bat コ ン パイ ル用バ ツチ ファイル 

cenv.bat MSX-C の 课境を 整える バ ツチ ファイル 

a ： ¥bin (コマンドの ディ レク トリ ¥bin の 内容） 

m80.com アセンブラ 

180.com リンカ 

cf. com コンパイラ （パ一 サ） 

cg. com コンパイラ （コード ジェネレータ） 
fpc.com ファンクション パラメータ チェッカ 
lib.tco FPC 用 標準 ライブラリ. tco ファイル 



a ： ¥include (ヘッダ ファイルの ディ レク 卜 リの 内容) 

bdosfunc.h 
como.h 
ctype.h 
directh 
io.h 

malloc.h 

memory.h 

process. h 

setjmp.h 

stdio.h 

stdlib.h 
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第 1 章 MSX-C コンパイラの 概要 



string.h 
type.h 

環境 変数の 設定 

INCLUDE a ： ¥include 

PATH a:¥; a ： ¥bin 

このまま では， エディタが 入って いません し， まだ 使いに くいので， ライブラリの 作成 をお こ 
なうた めの Iib80.com やその ための バッチ ファイル， MSX-DOS2 TOOLS などの テキスト ファ 
ィルを 扱う 各種 フ ィ ルタな ど を 加え る な ど， よ り 使いやすい 環境 を 作 り 上げて 下さ い. 

実際の プログラムの 開発に は， 上記の ような システム ディスクの 他に， ソース • ファイル や， 
コンパイラの ワーク 用の ディスク を 作る ことにより， 例えば 1DD の ディスク • ドライブ をお 持ち 
の 方で も 十分な スペース を 確保す る ことができ， 折角 作った ソース • プログラムが ディスク 容量 
不足の 為 セーブで きなかったり， システム ファイル を 壊して しまう といった トラブル を 避ける こ 
とがで きます. 

ワーク ディスクに は システム ファイルの 他， 必要 最小限の ファイル だけ を 入れて おき， ソース' 
ファイル を この ディスク 上に 作り ます. 

ディスク • ドライブ を 2 台 以上お 持ちの 方の 場合， A ドライブに システム 'ディスク， B ドラ 
イブに， ソース • ファイルの 入った ワーク • ディスク を揷 入し， 例えば， 

A>c b:head@ に bat を 起動し B ドライブの head.c を コンパイル する 

などの ように 入力 すれば 中間 言語 ファイル や， アセンブラ 'ソース， 実行可能 ファイル などす ベ 
てが， B ドライブ 上に 作られます. 

また， ディスク • ドライブが 1 台の ユーザー でも， MSX-DOS の 2 ドライブ • シミュレータに 
より， システム • ディスクと ワーク • ディスク を 交互に 抜き差ししながら， 同様に 2 枚の ディ ス 
クを 使い分ける ことができます. 

なお， 2 ドライブ' シミュレータの 詳細に ついては， MSX- DOS 等の マニュアル を ご 参照 下さ 
い. （ただし この 時には ディスクの 抜き差し 力 《 頻繁に なり， ディスクの 使い分けに 注意す る 必要が 
あります.） 
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1.4 サンプル 'プログラム 

付属の サンプル • プログラム について 解説し ます. 

1 .4. 1 サカル • プログラム 「HEADj の 仕様に ついて 



A) 概嬰 

HEAD は 指定され た， または 標準入力から 読み込んだ ASCII ファイルの 先頭から 指定の 行数 
を 出力す る UNIX 流の フィルタ コマンドです. 付属の ディスクに 収められた， サンプル 'ソース' 
ファイル head.c を 第 2 章の 操作 方法に 従い コンパイル 及び， リンクす る ことで， MSX - D0S2 上 
で 実行可能な. com ファイルと なり， I/O リ ダイレク ト， パイ プライン 等をサ ポー ト した 有用な ッ 
ール コマンド となり ます. 

具体的に は， 以下の ように 用います. 

A>head <f i lenane> 1^£) 

く filename) で 指定され た フ アイ ルの 先頭 か ら 10 行 を コ ン ツール 両面に 出力 します. このと 
き， 出力の 初めに ファイル 名が 表示され， 各行の 先頭に は， ファイルの 先頭からの 行 番号が つけ 
られ ます. 

B) ?T7 シ ヨン スィッチ 

HEAD コマンド では コマンド 名の 次に オプション スィッチの 指定で きます. これにより， 出力 
形式 や 内容な ど， コマンドの 動き を 変える ことができます. UNIX の コマンド では， オプション 
スィッチの 指定に は， のように ハイフンが 用いられ ますが， 本 プログラム では， "/" (ス ラッ 
シュ） 力、 これに 代わり 用いられ ています. 以下のような オプション スィッチが サボ 一卜されて 
います. 

オプション 名の 指定に は， 大文字， 小文字と も 指定 可能です. 

/L<lines> 出力す る 行数く lines〉 を 指定 します. 

/N ファイル 名， 行 番号の 出力 を 省きます. 
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第】 章 MSX-C コンパイラの 概要 



C) I/O リダイレクション， ノ 機能 

MSX-D0S2 が サボ一 ト します. 



D) エラー チエ クク， ワイルド カードな と' 

例えば， "/L" で 数字 以外の バラ メータが 指定され た 場合， 誤りの 箇所 等の 情報 を かえす とと も 
に， コマンドの 書式 を 表示し ます. 

入力 ファイルの 指定に ワイルド カード は 用いられません. 
ファイル を 指定し ない 場合 標準入力からの 入力と なり， コンソール 入力の ほか， 上記 リ ダイレク 
シ ヨン， パイプライン 等が 使用で きます. 

1.4.2 ソースファイル 飾 成 上の 埋恵点 



AWJ^Pfe ッサ 

すべての 標準 ライブラリ 関数の 宣言， マ ク 口 等の 宣言 は ヘッダ フ アイ ル stdio.h によって 取り 
込まれます. また， VOID 型 や BOOL 型の 定義 も こ の 中で typeh を 取り込む こと で 行われて い ま 
す. プログラムの 中で これら の 関数 や 型 等 を 使 う 場合 は ソースファイル の 先頭で # include プリ プ 
口 セッサ 文に よ り 取り込んで 下さい. 

ま た， MSX-C コ ン バイ ラ ではい く つかの プリ プロ セ ッ サ 文に よって， コ ン パイ ルモ一 ド を 様々 
に 切り替える ことができます. このう ち 本 プロ グラムで は # pragma nonrec の 指定に より デフ 才 
ルトの 関数 モー ドを非 再帰 型と しています. これらの プリ プロセッサ 文に よる 制御の 詳細に つい 
て は， 「3.1.1 # プリプロセッサ 文に よる 制御」 を 参照して ください. 

B) コ マン の 引数 

MSX-DOS 上で 入力され た コマンドへの 引数 は main () で 定義され た 関数の 引数 ar g C ， argv 
として ユーザー プログラムに 以下の ように 渡されます. 

(1) main () の 最初の 引数に は （引数の 数 +1) の 値が 整数 型で 与えられます. 

int argc; 

(2) 第 2 の 引数と して 実際の バラ メータへの ボイ ンタの 配列が 渡されます. 

char *argv 口； 
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rV ，く つ マゝノ K^, > ,T 


argc M " 




argv [1] 


o"< 第 1 引数〉" 











ここで， ユーザー プログラムと MSX- D0S2 のィ ン ター フェースの 役割 を 果たす のが CK (カー 
ネル） とよ ばれる モジュールです. 力一 ネルで は main () に 制御が 渡る 前に コマンド 行の 解析 を 
おこないます. 上記の ように main() に 渡されます. 例えば， 

A>head < test 0 

のように コマンド 入力 さ れた 場合 バラ メータの 数 は 0 個， 従って main ( ) の 最初の 引数に は 1 が 
渡される ことにな り， ユーザ一 プログラムの 屮 では ファイル test は ファイル ボイ ンタ stdin によ 
つて アクセスが 可能になります. 

A>head 0 

とのみ 入力され た 場合 も 同様で あり， ただ， この場合 stdin が ファイル ではな く コンソールに 割り 
当てられます. 

なお， 標準 力一 ネル 機能の 詳細に ついては 「1.1. 3 標準 カーネルの 諸 機能」， 「4.5.1 MSX-C 
ライブラリの 構成」 を 参照して ください. 



G) 鹏 の憲霣 

c 言語に よる プログラミングの 特徴と して プログラム 力 《複数の 比較的小 さな モジュール （関数） 

に 分けて 書かれる ことが 多く あり ます. MSX-C では 呼び出される 関数が 他の モジュールで 定義 
されて いる 場合 （標準 ライブラリ など はま さに この 例） はもち ろん， 同一 の ソースファイルで 定 
義 する 場合で も 呼び出す 側よ り も 後で 定義す る 場合に は 呼び出す 関数 を あらかじめ 宣言して おか 
なければ な りません. ライブラリ 関数の 呼び出 し に はへ ッ ダフ アイ ルのィ ン ク ルー ド によって こ 
れを おこない ますが， 同一 の ソース 内の 関数の 宣言 は 

(1) 呼び出す 側の 関数の 冒頭で これ を 宣言す る. 

(2) 呼び出される 関数 を 呼ぶ 側の 関数よ り 前で 定義す る. （この場合 宣言 は 必要ない） 

(3) ソースの 冒頭で， その モジュールで 呼び出される 関数 を まとめて 宣言す る. 
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第 1 章 MSX-C コンパイラの 概要 



などに よりお こない ます. 本 サンプル では 2 番目の 方法 を 用いて います. （main () が ソースの 一 
番 最後で 定義され ている 点に 注意， 3 番目の 方法 を 用いる 場合 は， main () から 順番に ソース プロ 
グラム を 書いて い く 事が 可能です. ) 

このように MSX-C では 「参照され る 識別子 は， 前もって 宣言して おく」 という スタイル を 貫 
くた めに 標準 C のよう な 暗黙の 宣言 はお こない ません. しかしながら， CF の 起動時に" -r スィ ッ 
チを 指定す る ことによ り 「宣言され ていない 関数 は int 型 を 返す」 と 仮定し， 暗黙のう ちに 宣言し 
たのと 同様の コ ン パイ ルが 可能 となって ます. 
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第 S 章 — MSX-C コンバ イラの 操作 



ファイル 
： コ マン ド 



(D 



テキスト 入力 






エディタ 




广"^ 



.C フ アイ メレ 



標準 ライブラリ 
中間 言語 ファイル 

lib.tco 

(HO 



•tco ファイル 

—一 — 1 


中間 言語 
ファイル 


、 

C 


f 

F 



FPC ^ 



関数の 引数の 型 を チェック （ IV ) 
(ファンク ショ ン パラメーター チェ ッカ） 



| .tco フ 


： _ >| 
'アイ ル 






CG 


- — ^ 


7 


* — - — 

.mac フ アイ ジレ 



(V) 



アセンブラ 

M80 



プログラム 作成 



C 言語 ソース プログラム 



構文 解析 をす る ( 
(パーザ） 



中間 言語 ファイル 



アセンブリ 言語の コード を 
生成す る。 

(コー ド ジヱネ レー タ） 



アセンブリ 言語 プログラム 



ライブラリ 
ファイル 

ck'rel 
clib.rel 
crun.rel 
cend.rel 



•rel ファイル 



(VI) 



アバ ッガ 
SBUG 



.rel フ 

— - , 


^1 
アイ ル 






. リンカ 
? し 80 



_| .com ファイス レ 



才 ブジェク ト ファイル 



実行 ファイル 



図 MSX-C の プログラム 開発 
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第 2jS MSX-C コンパイラの 操作 

2.1 バッチ フ ァィ紘 ついて 

c の ソース プログラム （. c ) から 実行 プログラム し com) を 生成す るに は， 数個の コマンド を 
実行す る 必要が あります. しかし， ひとつひとつの コマンド を キーボードから 入れて いると 手間 
や 時間が かかり ますし， 誤り も 多くな つてし まいます. そのため， ソース プログラムの コンパ ィ 
ル から 実行 プログラムの 生成まで を ひとつの コマンドで 済ませる ための バッチ フ アイ ルが 用意 さ 
れ ています. 

MSX-C に 付属す る c.bat という バッチ ファイルの 内容 は 次のように なって おり， エラーが な 
ければ これによ つて ソース プログラムから 実行 プログラム を 一気に 作成し ます. （24 ページの 図 
の (II) から （VI) まで) 

cf %2 XI 
fpc lib %l 
eg -k %% %l 
n80 =%l/z 
del Xl.mc 

180 ck, XI , cl ib/s, crun/s,cend , Xl/n/y/etxiain 

c.bat による コ ン パイ ルの ための 書式 は 次の よ う にな り ます. 
A>c filename Q^J 

ここで， filename は コンパイル する ソース プログラム 名で， これ は 拡張 子な しで 指定し なければ 
なりません. 

では， 実際に ソース プログラム を コンパイルして みましょう • ここで 使用す る ソース プロ グラ 
ム は head.c で， これ はフ アイ ルの 先頭の 部分 を 切 り 出し て 表示す る プロ グラムです • 

A>c head0 O 実際に キーボードから 入力す るの はこの 1 行 だけ 

MSX-C ver 1.20x parser) 

Copyright (C) 1989 by ASCII Corporation 

complete 

MSX-C function paraneter checker ver 1.20x 
complete 

MSX-C ver L20x (code generator) 
Copyright (C) 1989 by ASCII Corporation 
puthlp . . ； 
putusage . ； 

atoix ： ： ； 

shifarg ：：：； 

parsesw ：：：：：； 

ts ::; 

typehead ：：：； 

nain ：：：：：：； 

complete 
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No Fatal error (め 



MSX.L-80 1.00 Ol-Apr-85 (c) 1981,1985 Microsoft 

Data 0103 182E < 5931> 

36744 Bytes Free 
[0103 182E 24] 

A> 

これで コンパイルと 実行 プログラムの 生成 は 正常に 終了して います. ここで 新たに 作成され た 
ファイル は， headrel, head.com, head'sym の 3 つです が， head.com が 実行 プログラムです. 

実行 プロ グラムが 生成され たので， head.com を コマンド として， た とえば 次の よ う に 使用す る 
ことができる ようになります. 

A>head /n /15 head.c0 

こ の 例で は， head.c の 先頭 か ら 5 行をフ アイ ル名 を 省いて 表示 します. 



a.g 各コ マン Kg) 操作 

2.1 では バッチ ファイル を 使用して， ソース プログラムから 実行 プログラムの 生成まで を一 度 
に 行い ましたが， バッチ フ アイ ル 中で 起動 された それぞれの コマンド を 別個 に 起動す る こと もも 
ち ろ ん 可能です， 本節で は それぞれの コマンド について 解説し ます. 

g,S,1 CF (バーサ) 

CF の 書式 は 次のと おりです. 



CF [オプション] filename 

ここで filename は， C の ソースファイル 名です. ファイル 名 は ドライブ 名， パス 名， 拡張 子 を 
指定す る こと もで きます. 拡張 子 は 省略され る と .c が 使われます. ま た 拡張 子 を 指定す る と. (：以 
外の 拡張 子の ファイル を C の ソースファイルに できます. 

CF は， MSX-C コンパイラで C の ソース フ アイ ルを コンパ ィ ル する 際に， 最初に 実行し なけれ 
ばなら ない プログラム （コンパイラの 第 1 バス） です. （24 ページの 図の （II)) CF は 入力と して 
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第 2 章 MSX-C コンパイラの 操作 



C の ソースファイル （filename で 指定） を 読み， 出力と して 中間 言語 ファイル を 書き出します • 
その 際に， ソースファイルの すべての エラ一 （文法 や 意味 上の エラー） 力 《 検出され ます. 

CF は 中間 言語 ファイルと エラー メ ッ セージの 出力 を 行います. 中間 言語 フ戸ィ ルはソ 一スフ 
アイ ルの ある ディ レク ト リ に 出力され ます. エラーが あった 場合に は 中間 言語 ファイル は 生成 さ 
れ ません. 

コ ン バイ ル 中に Ctrl+C や Ctrl+STOP を 押す ことで， コ ン パイ ルを 中断す る こ とがで きま 
す. ただし 中間 言語 ファイルが 残り ますので 削除して 下さい. 

中間 言語 は T コード と 呼ばれ， CF で 出力され る 中間 言語 フ ァ ィ ルは 拡張 子. tco を 持ちます. 
この. tco ファイル は， FPC (パラメータ チェッカ） や CG (コード ジェネレータ） の 入力と して 使 
用され ます. 

Ver. 1.2 では 文字列 中の 漢字 も 正しく 認識で きる ようになりました. Ver.1.1 まで は漠 字をコ 
メント に 使う こと はでき ました 力、 文字列 中に 漢字 を 使う と 文字に よって は 変化して しまい， 不 
都合が 生じて いました， 新しい CF では これ をスィ ツチに よって 漢字 を 正しく 認識す るよう に 指 
定 できます. 

通常 C の プログラム では ヘッダ ファイル をィ ンク ルードし ますが， Ver. 1.2 から はィ ン クルー 
ド ファイルの ある デフォルトの ディ レク ト リを 指定す る ことができます. ディ レク ト リは MSX- 
D0S2 の 機能で ある 環境 変数で 指定し ます. 環境 変数 INCLUDE に ディ レクト リ名を 設定して お 
いて， それから CF を 起動す る ことになります. ディレクトリ を ひとつ 作り， そこに MSX-C 付 
厲の ヘッダ ファイル をす ベて いれて おき， その ディ レク ト リ名を 環境 変数 INCLUDE に 設定して 
おきます. こうす る ことで， コンパイル のたびに ヘッダ ファイルが あるか どうかな ど を 気にする 
必要が なくなります. A ドライブに ^include という ディレクトリ を 作り， その 中に ヘッダ フ アイ 
ルを 入れた とする と， 墚境 変数 INCLUDE の 設定 は 次の よ う に 行います. 

A>set include=a:¥ include i^£] 

普通 はすべ ての ヘッダ ファイル を 読み込む ため ディスク アクセスが 多く， 時間が かかって しまい 
ます. RAM ディスク （H ドライブ） に 十分 余裕が あるならば そこに ディ レクト リ ごと コピーして 
から 使う とより 早く コンパイルが 終了し ます. 

以下に 指定で きる オプションと， その 意味 を 説明し ます. 



ぉシ ヨン 

一 c コメント を ネストし ない. 

MSX- C では 標準 C と 異なり， コメント を ネストす る ことができます. しかし こ 
の オプション は コメントの ネス トを 抑制し， コメント を 標準 C の 場合と 同様に 扱 

います. コメントの ネストと は ソースファイル 中で， 次の ような ことができる こ 
と をい います. 
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/* 

int 

char 

{ 



} 



same fuction is defined in Standard Library stdlib.c 
atoi(s) 



int 
char 



0； 



for (i = 0； (c = お） >= '0' && c く 二 ，9，； s++) 

i = i * 10 + c - ，0，； /* when c == ，0，， shift and add 0 */ 

/* when c == ，9，， shift and add 9 */ 
return (i); returns value 



これ は atoi () を 自分で 作り ま したが， 標準 ライ ブラ リ に 同じ 関数が あるの が 分 
かった ので， コメントに する ことで 定義 を やめた ものです. この 関数で は 内部に 
処理に 対す る コメント が 書かれて いる ので， コメント を 含めて 関数 を コメントに 
してし まっています. ，，オプション を 指定した 場合， 最初の"/ *" から" returns 
value */，， まです ベて コメントになります が， 関数の 終わり を 示す" } "と" *广 が 
コメントで なくなって しまいます. つまり， コンパイル 時に なんらかの エラ一 が 
発生す る はずです. 

[filename] エラー メ ッ セージ を ファイルに 出力す る. 

通常， CF が 生成す る エラ一 メ ッ セージ はすべ て 標準出力 （コンソール） に 出力 さ 
れ ますが， この オプション を 指定す ると， エラ 一メッセージ は ファイルに 出力 さ 
れ ます. 出力 先 ファイル は filename で 指定し ます. ファイル 名 は ドライブ 名， パ 
ス名， 拡張 子 を 指定す る こと もで きます. 拡張 子 は 省略され ると. dia が 使われ ま 
す. また 拡張 子 を 指定す る と .dia 以外の 拡張 子の ファ ィ ルを .dia フ アイ ルの 出力 
先に 指定で きます. filename に アルファべ ッ ト 1 文字 または それに" '• "(コロン） 
を 指定す ると その ドライブの カレント ディ レクト リ に， "¥ ，，で 終る ディ レクト リ 
名 を 指定 すれば その ディ レクト リに， "¥ "以外で 終れば それ を ファイル 名と して 
エラ一 メ ッ セージ を 出力し ます. filename を 省略す る と， .dia ファイル は ソース 
ファイルと 同じ ディ レク ト リに 作成され ます. エラーがなかった 場合に はフ アイ 
ルは 生成され ません • この オプションの 後に は 他の オプション はつ けられません. 

宣言され ていない 関数と パラメータ を 暗黙 的に int 型と して 扱う. 
標準 C では 宣言され ていない 関数 や 関数の バラ メータ は int 型と して 扱われます 
力、 MSX-C では これ を デフォルト では 禁止して います. この オプション を 指定す 
ると， これらに ついて int 型が 暗黙に 仮定され， 標準 C との 互換性 を 保ちます • 
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-j 文字列 中の 漢字 を 正し く 認識す る. 

この スィ ツチ を 使わない と 文字列 中に 漢字 を 入れた 場合， 文字が 正しく 認識され 
な レ 、場合が あります. これ は 漢字 コ 一 ド に C 言語の エス ケー プ 文字" ¥ "が 使わ れ 
るた めで， づを 指定す る ことで 漠字を 正しく 認識す るよう になります， 文字列 中 
に 漢字が 含まれる ときには この スィ ツチ を 使って 下さい. 逆に 半角 （1 バイ ト） の 
ひらがな を 使って いる ときには 使って はいけ ません. 半角 ひらがな や 漠字を 使つ 
ていない 場合に は どちらで も 構いません 力 八 指定し なくて いいでしょう. 

- o [filename] 中間 言語 ファイル （.tco ファイル） を 任意の ディ レク ト リ に 作成す る. 

デフォルト では， tco ファイル は ソースファイルと 同一 ディ レクト リに 生成され 
ます. この オプション を 使えば 任意の ディ レク ト リに 任意の ファイル 名で 中間 言 
語フ アイ ルを 作成す る ことができ ま す. 

filename は，. tco ファイルの 出力 先 を 指定し ます. アルファべ ッ ト 1 文字 または 
それに" ： "（コロン） を 指定す ると その ドライブの カレント ディ レク 卜 リに， "¥，' 
で 終る ディ レク ト リ名を 指定 すれば その ディ レク ト リ に， "¥ "以外で 終れば それ 
を ファイル 名と して 中間 言語 ファイル を 出力し ます. filename を 省略す ると， デ 
フォルトと 同じ 動作 をし ます. この オプションの 後に は 他の オプション はっけら 
れ ません. 

-otest¥ test という ディ レク ト リ に 中間 言語 ファイル を 出力し ます. 

-o¥foo.t ¥foo.t という ファイル 名で 中間 言語 ファイル を 出力し ます. 

- rP ： S ： H コンパイラの ワーク 用 テーブル を P ： S ： H の 比率で 割り当てる. 

ここで， P は プール， S は シンボル テーブル， H は ハッシュ テーブル を 表します. 
デフ オルト では この 比率 は， 13 ： 6 ： 4 となって いま す. CF でコ ン パイ ル 中に テー 
ブル オーバ一 フローが 起こった 場合に は， オーバー フ 口一となった テーブルの 数 
値 をより 大きく して， 再 コンパイルして ください. 

- m メモリ の 使用 状況 を 表示す る . 

，，-r "オプションで 説明した P ： S ： H の それぞれ について， メモリ の 配分が 示さ 
れ ます. コンパイルに 成功した 場合に は， 通常の場合と 同様， 中間 言語 ファイル 
が 作成され ます. 表示の 形式 は 次のように なって います. 

pool く 使用 バイ 卜 数 > /く 割当 領域 パイ ト数〉 

symbol table く 使 ffl バイ ト 数〉/ く 割当 領域 バイ ト数 > 

hash く 使用 バイ ト 数〉/ く 割当 領域 バイ ト数〉 
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"/"の 左側の く 使用 バイ ト数 > は テーブルの 現在までに 使用した バイ ト 数です. く 
割当 領域 パイ ト数 > は テーブルに 割り当てられた 使用で きる 最大 バイ ト 数です. 
テ 一 ブル ォ 一バー フローが 起きた とき に は 自動的に メモ リ 配分が 表示 されます の 

で， それぞれ のく 使用 バイ ト数 > を 見て， だいたいの 比率 を" -r" で 指定して 下さ 
い. 

- s ソース プログラムに エラーが 検出 されても， バッチ 処理 を 続行する. 

分割 コ ン パイ ルを 行う 場合に， ひとつの バッチ フ アイ ル 中で 複数の ソ一 スフ アイ 
ルを コンパイル するとき に， この オプション は 特に 有効です. ひとつの ソース プ 
ログ ラム 中の エラーで 全体の 処理 を 中断して しまう ことなしに， すべての ソース 
ファイルの エラ一 チェック を 行う こ とがで きます. 

-t ボイ ンタ と 整数の 間の 自動的な 型変換 を 可能に する. 

MSX-C の 場合， デフォルトで はこの ような ポインタと 整数の 間の 型の 混用 はェ 
ラーと なります. この オプション によって， ポインタと 整数の 間で， 型変換が 自 
動的に 行われる ようになります. "- f， ォプシ ヨンと こ の" -t" ォプシ ョ ンを 使用 し 
なくても コ ン パイ ル できる ような プログラム を 書く こと 力く， MSX-C の 場合に は 
推奨され ます. 



エラー メ viz —ジ について 

エラー メ ッ セージ は 2 種類あります. コマンドの 動作に ついての メ ッ セージと コンパイル 結果 
のメ ッ セージです. ここで は それぞれの メ ッ セージに ついて どのような もので あるかの 説明に と 
どめます. 実際の エラーメッセージ は 「8.1 CF の エラ一 メッセージ」 を ご覧 下さい. 

コ マン ドの 動作に ついての メ ッ セージ 

これ は CF コマンドの 動作に ついての メ ッ セージです. 例えば， ソースファイルが 見つからない 
などの メ ッ セージです. このような メ ッ セージが 表示され た ときには， CF は ほとんど 処理 を 中止 
して コマンド レベルに 戻り ます. 

コンパ ィ ル 結果の メッセージ 

ユーザーの ソースファイルの コンパイル 結果の メ ッ セージです. この場合 は CF は ソース をな 
るべ く 正しく 認識しょう としつつ， コンパイル を 続けます. しかし， ワーク ヱ リアがない などの 
エラーの 場合に は 処理 を 続ける こと 自体で きないので， 処理 を 中止して コマンド レベルに 戻り ま 
す， 

この メッセージの 場合， 出力 形式が 2 種類あります. 次の ような ものです. 

(1) line M column N ： < message > 

(2) < message > 
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く message> は エラーメッセージ を 示し， M， N は それぞれ エラ一 のあった 行， 桁 を 表して いま 
す. （1) は その 位置で エラーが 発生した こと を 示して います. （2) は 範囲が 広くな ります. その 範囲 
は あるひと つの 関数 内 や ソースファイル 全体です. 

メ ッ セージ は 普通， 非常に 的確に エラーの 指摘 をし ますが， "} "など 重要な 意味 を 持った 文字 を 
忘れる と， それ 以降の C 言語の ソース を 正しく 解釈で き なくなり， 大量の エラーメッセージ を 発 
生 させて しまいます. （これ は， 自由形 式 (文字列 外の 空白 文字と 識別子 を 区切る 空白 文字 を 無視 
する） である C 言語の 特徴で も あり ます.） この 大量に 発生した メ ッ セージ はすべ てが 的確に エラ 
一 を 指摘して いる わけで はなく， ほとんどが 正しく 解釈で きなかった ものに 対する メッセージで 
す. このような 場合 はだいた いの 原因 は， 大量に 発生した メッセージの 最初の 部分に 本当の エラ 
—があります. それ を 修正す る ことで メ ッ セージ はずい ぶん 減る でしよう. 

エラー メッセ 一 ジの 表示 方法 に は 2 種類 ある こと は 述べ ま し たが， 「8.3 FPC の エラー メッセ 
—ジ」 では 行 や 桁の 表示 は， すべて 省いて あります. 



先の head.c を 例に とって， 実際に CF でコ ン バイ ル してみ ます. 



A>cf head @ 

HSX-C ver 1.20x (parser) 

Copyright (C) 1989 by ASCII Corporation 

complete 

A>dir head.*@ 

HEAD C 3802 89-01-17 2:53p _ 
HEAD TCO 5888 89-01-17 2:54p O 中間 言語 ファイル 
9K in 2 files 473K free 



次に， ソース プログラムに エラー を 持つ error.c という プログラム を コンパイルし， その エラー 
メ ッ セージ を コンソールで なく ファイルに 出力し ます. 



A>cf - e error \J} 

MSX-C ver 1.20x (parser) 

Copyright (C) 1989 by ASCII Corporation 

errors detected 

A>dir error,* 0 

ERROR C 3845 83-01-20 7:56p 
ERROR DIA 256 89-01-20 9:21p O メッセージ ファイル 
4K in 2 files 473K free 
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g,g-S FPC (パラメ づチ r:; 力) 

FPC の 害 式 は 次の と お り です. 

FPC [オプション] filel file2 ... 

ここで filelfile2 …は 中間 言語 ファイル （.tco ファイル） 名です. ファイル 名 は ドライブ 名， 
バス 名， 拡張 子 を 指定す る こと もで きます. 拡張 子 は 省略され ると. tco が 使われます. また， ヮ 
ィ ルド カード （* や？） を 使用す る こと もで きます. 

FPC の 目的 は， 宣言され ている 関数の 戻り 値の 型が 実際の 戻り 値の 型に一 致して いるか どう 
か， また， 関数に 渡した パラメータの 型が， 関数 宣言で 定義され ている パラメータの 型と一 致し 
ている かどう か を 調べる ことにあります. （24 ページの 図の （III)) つまり， FPC を 使用す る こと 
によって， 意図し ない パラメータ や 関数の 型の 不一致に よる 潜在的な バグの 可能性 を 最小限に 抑 
える ことができます. なお， すべての 標準 ライブラリ 関数の 型の 情報 は， lib.tco という ファイル 
に 存在し ます. 

実際に 例 を あげて 説明し ましょう. 以下の ソース プログラム （test.c とする） を 見て ください, 



き include <stdio.h> 

nainO 
{ 

int flO, f2(), x， y; 

x = fl('a'， 3); 
y = f2(); 

printf("Xd XcHfn", x， y); 

) 

int fl(x, y) 
int x, y; 
( 

return (x + y); 

} 

char f2() 
{ 

return ('b')l 

) 



• • • 012345678901 

123456789111111111122 
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この プログラム では， まず 関数 main () の 中で 2 つの 関数 fl (),f2 () が それぞれ int 型と して 
宣言され ています （5 行 目）. 一方， 関数 fl() は， int 型の 2 つの バラ メータ を 取る ものと して 定 
義 されて います （12〜13 行 目）， ところが 関数 main () 中で は， 関数 fl ( ) への 第 1 パラメータと 
して， "a" という char 型の バラ メータ を 渡して います （7 行 目）. さらに， 関数 f2 ( ) は int 型と し 
て 宣言され ている のに， 関数 定義で は char 型の 戻り 値 を 持つ ものと して 定義され ています （18 
〜21 行 目）. 

ところが， これら 2 つの 型の 矛盾 は パーザ （CF) では 検出され ません. 意図し ないで このよう 
な 矛盾 を 起こして いる 場合に は 当然 バグの 原因と なります が， FPC はこうした 問題 を 検出し， ュ 
一 ザ 一に 指摘して くれます. 

では 実際に この ソース プログラム を コンパイルして， FPC で チェックして みましょう. 



A>cf test@ 

MSX-C ver 1.20x (parser) 

Copyright (C) 1989 by ASCII Corporation 

complete O バーサ は 問題な く 通る 

A>fpc lib test@ 

MSX-C function parameter checker ver 1.20x 

in <test.tco> ，，iain" calls n f\ n ： 1st argument conflict 

in <test.tco> w nain" calls M f2 M ： conflicting return type 

complete 

A> 



このように， 関数 fi () の 場合に は 「関数の e 初の パラメータの 型が 不一致」， 関数 f2() の 場合 

に は 「戻り 値の 型が 不一致」 と， 正確に 矛盾が 指摘され ています. なお， FPC の コマンド 行で" lib" 
(lib.tco) を 指定して いるの は， プログラム 中に prin ば （） という 標準 ライブラリ 関数が あるた め 
です. 

FPC は， CF (バーサ） が 正常に 終了した 直後に 生成され た 中間 言語 ファイル （.tco ファイル） 
に対して 実行す るよう にしておく とよいで しょう. 

カレント ディ レクト リに， 与えた 中間 言語 ファイルが 見つからない 場合に は， fpc.com のあった 
ディ レク ト リ を 探します. それでもない 場合 は" cannot open ： く filename〉 "と 表示して 終了し 
ます. ドライブ 名 や ルート ディレクトリからの 指定が あると この 機能が 発揮され ません. lib.tco 
などよ く 使う .tco ファイル は fpc.com と 同じ ディ レク ト リ に 置き， パス 名な しで ファイル を 指定 
すると lib.tco の 存在 を ほとんど 意識し ないです みます. この場合， カレント ディレクトリに lib. 
tco が あ つ た 場合に は それが 使われ ま す. 



7T7 シ ヨン 

-s FPC で エラーが 検出され た 場合で も， バッチ 処理 を 続行す る. 

分割 コ ン パイ ルを 行う 場合な ど， 多 く の プログラム を 一度に チヱ ッ ク する 場合に 
便利な オプションです. 
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一 u 



未定義 関数に 対する 参照 を チュッ ク しない. 

この オプション を 指定す ると， 未定義 関数 を 参照す る 記述が 存在 しても エラーに 

なりません. 



- 1 型の チヱ ックを さらに 厳しく 行う. 

デフォルト では int， unsigned, ポインタ は 同じ 型で あるよう に 処理され ますが， 
この オプション を 指定す ると これら はまった く 別の 型と して チェック されます. 

-' 間接 呼び出し に対して 警告 を 出す. （エラーメッセージの 項 を 参照） 

-c < filename > ライブラリ 関数 用 の. tco ファイル を 作成す る • 

ライブラリ 関数のへ ッ ダ 部分 （引数と 戻り 値） だけの 情報 を 残し， . tco ファ ィ ルを 
圧縮， 連結した もの をく filename) に 作成し ます. こうす る ことで， ライブラリ 
開 数 を FPC で チェックす るの に 必要な 情報 だ けにな り， フ アイ ル に 必要な デ ィ 
スク スペースが 小さ く なります. く filename) より 後ろの ファイル 名 は 圧縮， 連結 
する ファイルと して 解釈され， 関数の 引数の チェ ッ ク な ど は 行われません. く 
filename> に は ドライブ 名， バス 名， 拡張 子の 指定が できます. 拡張 子 は 省略 さ 
れ ると. tco が 使われます. 具体的な 使用方法 は 「4.5.3 専用 ライブラリの 作成」 
を 参照して 下さい. 

- d< don't care don't care 関数の 指定 をす る. 

閱数 リスト〉 don't care 関数と は， 呼び出し 時に 余分な バラ メータが 付いていても， それ を 許 
す ものです. 例えば， 関数 bdos() は， iMSX-DOS の ファンクション コールに よ 
つて は， 第 2 引数がなかったり， int 型だった り char 型だった りと， 一定 しませ 
ん. したがって， 何も 指定せ ずに チヱ ック用 ファイル を 作る と， FPC で チェック 
を 行った ときに "パラメータの 数 や 型が 合わない" という メッセージが 出力され 
てし まいます. このような場合に 対応す るた め， "-d" スィッチ を 使用し ます， く 
don't care 関数 リスト〉 は， 関数 名 を カンマ （，） で 区切って つなげます. 空白 
を 入れて はいけ ません. 例 力、 標準 ライブラリ 再 作成 用 バッチ ファイル gentco. 
bat を 参照して 下さい. また， この スィ ツチ は" -c" スィ ツチと 一緒に 使わなければ 
意味が ありません. 



I 例 I 

A>fpc -c 隨 ylib -d bdosd'bdosb nylibl nylib2 @ 

この 例で は mylibl.tco, mylib2.tco を 圧縮， 連結し mylib.tco を 作成し ます. その 際， bdosd 
( ) と bdosb ( ) は 余分な 引数 を 無視す るよう になって います. 
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エラー; t ま ージ 

以下の 部分で は， 

filename は， エラーが 発見され た ファイル 名 
fund は， エラーが 発見され た 関数 名 

func2 は， その 関数に 対する 呼び出しで エラーが あった 関数 名 

を， それぞれ 示します. 

in < filename > "funcl" was multiple defined 

funcl 力、 プログラム 中で 二重 （あるいは 多重） 定義され ている. 

in < filename > "funcl" 〜sorry,can"t check indirect call 

fund が 別の 関数 を 間接的に 呼び出して いるので， パラメータの チ 
エック はでき ない. 

この メッセージ は， -i オプション を 指定した 時に だけ 表示され ます. これ は， 関数への ポ イン 
タを 使って いる 場合に 起り ます. たとえば， 次の ような 場合です. 

int (*fp)(), func(); fp は 関数への ポインタ %1 

fp = tunc; ズ * fp は func を 指して いる 

(ま fp)(l, 2)； か これ は 問 接 呼び出し なので チ ユックで きない */ 

その他の エラー メ ッ セージ は， 以下のような 共通の 形式で 出力され ます. 

in < filename > "funcl" calls ，，fimc2" ； メ ッセ一 シ 
ここで， 『メッセージ』 は 以下の いずれ かになります， 

(1) conflicting return type 

func2 の 返す 型が， 関数 定義 本体の 型と 一致し ない. 

(2) conflicting number of arguments 

func2 の 呼び出しで， 弓 I 数の 数が 定義と一 致しない. 

(3) く Nth 〉 argument conflict 

func2 の 呼び出しで， N 番目の 引数の 型が 定義と 一致し ない. 

1 番目， 2 番目， 3 番目の 引数の 時には" Nth" は それぞれ， "1st"， "2nd"， "3rd" になります. 

(4) undefined 

func2 が 参照され ている にもかかわらず， どこに も 定義され ていない. 
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a,g,3 CG (コード ジェネレータ） 

CG の 書式 は 次の とおり です. 

CG [オプション] filename 

ここで filename は CF が 出力した 中間 言語 ファイル （.tco ファイル） です. ファイル 名はド 
ライブ 名， パス 名， 拡張 子 を 指定す る ことができます. 拡張 子 は 省略され ると. tco が 使われ ま 
す. 

CG は コンパ ィ ラの コード 生成 フェーズ であり， CF によって 生成され た 中間 言語 ファイル を 入 
力と して 読み込み， アセンブラの ソースファイル を 出力し ます. （24 ページの 図の （IV)) 出力され 
る アセンブラの ソース フ アイ ルの 拡張 子 は， ， mac です. コード 生成 中 に ェ ラーが 発生 し た 場合に 
は. mac ファイル は 生成され ません. 

CG の 出力 ファイル は そのまま M80 マクロ アセンブラの 入力と して 使用され ます. すなわち， 
MSX-C コンパイラ 自体の 処理 は アセンブラの ソースファイルの 出力まで であり， そこから 実際 
の 実行 ファイルの 生成までの 処理 は マクロ アセンブラと リ ン 力が 行う ことになります. 

コード 生成 中に Ctrl+C や Ctrl + STOP を 押して， 処理 を 中止す る ことができます. 

お シ ヨン 

- k コード 生成の 終了 時に， 入 カフ アイ ル である 中間 言語 ファイル （.tco フ アイ ル） 

を 自動的に 削除す る. 

-I フルネームの 生成. 

CG は 通常， グローバル シンボルの 先頭から 6 文字まで しか アセンブラ 出力に 対 
して^ 成しません が， この オプション によって グローバル シンポ ル名 全体が 有効 
になります. 

-0 [filename] 出力 ファイル を 指定した ディ レクト リに 生成す る. 

デフォルト では， mac ファイル は. tco ファイルと 同一 ディ レク ト リ に 生成され ま 
す， この オプション を 使えば 任意の ディ レク ト リに 任意の ファイル 名で 中間 言語 
フ アイ ルを 作成す る こと がで きます. 

filename は，. mac ファイルの 出力 先 を 指定し ます. アルファべ ッ ト 1 文字 または 
それに" ： "（コロン） を 指定す ると その ドライブの カレン 卜 ディ レク ト リに， ，'¥" 
で 終る ディ レク ト リ名を 指定 すれば その ディ レク ト リ に， "¥ "以外で 終れば それ 
を ファイル 名と して アセンブラ フ アイ ルを 出力 します. filename を 省略す る と デ 
フ才 ノレ ト と 同じ 動作に なり ます. この オプションの 後に は 他の オプション はっけ 
られ ません. 
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厂 例 I 

-otestV test という ディ レクト リに 中間 言語 ファイル を 出力し ます. 

-o¥foo.asm ¥foo.asm という ファイル 名で 中間 言語 ファイル を 出力し ます. 

-rN シンボル テーブル 領域と して N バイト 確保す る （N は 10 進数). 

-u 処理の 進行状況の 非 表示. 

この オプション を 指定す ると， 現在 処理 中の 関数 名と， 進行状況 を 示す， ". "（ピ 
リオ ド） や" ： ，， （コロン)， "；" （セミコロン） の 出力 （後述の 例 を 参照） をし ま 
せん. 

エラー メ化 ージ ICQ いて 

CG にも エラー メ ッ セージ は 2 種類あります， コマンドの 動作に ついての メ ッ セージと コンパ 
ィル 結果の メ ッ セージです， ここで は それぞれの メ ッ セージに ついて どのような もので あるかの 
説明に とどめます， 実際の エラーメッセージ は 「8.2 CG の エラーメッセージ j を ご覧 下さい. 

コ マン ドの 動作に ついての メ ッ セージ 

これ は CG コマンドの 動作に ついての メ ッ セージです. 例えば， .tco ファイルが 見つからない， 
ワーク エリ ァが 不足して いるな どの メ ッ セージです. このような メ ッ セージが 表示され たと きに 
は， CG は 処理 を 中止して コマンド レベルに 戻ります. 

コンパイル 結果の メッセージ 

.tco ファイルの コンパイル 結果の メ ッ セージです. CG は コンパイルの 結果と して は 警告 メ ッ 
セージ （warning) を 発生させる だけです. 

先の HEAD プログラム （1.4 参照） を CG で 処理して みます. これ 以降の 処理で は 中間 言語 フ 
アイ ルは 不要な ので， - k オプション を 指定して. tco ファイル を 削除して います. 

A>dir head.*@ 

HEAD C 3802 89-01-17 2:53p 

HEAD TCO 6888 89-01-17 2:64p O 中間 言語 ファイル 

9K in 2 files 473K free 
A>cg - k head@ 

MSX-C ver L20x (code generator) 
Copyright (C) 1989 by ASCII Corporation 
puthlp - - ； 
putusage • ； 
atoix ：：； 
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shifarg ：：：； 

parsesw 

ts ：：; 

typehead 

nain , ....:::;;;； 

complete 
A>dir head.*@ 

HEAD C 3802 89-01-17 2:53p 
HEAD MAC 9330 89-01-17 2:58p 
12K in 2 files 463K free o tco ファイルが 消去され， アセンブラの ソースファイル 
k (.mac ファイル） が 生成され ている 



この 例で は -u オプション を 指定して いないため， 処理の 進行状況が 表示され ています. 進行 
状況と して 最初に 表示され るの が， 現在 処理して いる 関数 名です. それに 続いて 表示され ている 
ピリオド は， 閼数 中の それぞれの 文 （ステートメント） が 処理 中で ある こと を 表し， コロンが 表 
示されて いるものに ついては， そこで 最適化の パスが 動作して いる こと を 示して います. 



S,g,4 アセン ブルと リンク 

さて， 前節までで MSX-C コンパイラ 自体の 処理 は 終了し， 出力 ファイル として 得られた ァセ 
ン ブラの ソースファイル （，n ] ac ファイル） を M80 マクロ アセンブラに 渡し， さらに L80 リ ンク 
ローダ を 起動す る ことによって， 最終的な 実行可能 ファイル （.com ファイル） を 作成し ます • (24 
ベ一 ジ 図の (V) と （VI)) なお， MSX-C プログラムの リンク 時には， 次の 4 つの. rel ファイルが 必 
要です. 



ck.rel 
clib.rel 
crun.rel 
cend.rel 



MSX-C 標準 カーネル 
MSX-C 標準 ライブラリ 
実行時 ルーチン 
ト レー リ ング ファイル 



ここで は 前節に 続いて， HEAD プログラムの 作成 を 例と して， 実行可能 ファイルの 作成まで を 
見て 行きます. 



A>n80 =head @ O アセンブラ の 起動 

No Fatal error(s) 
A>dir head.0 

HEAD C 3802 89-01-17 2:53p 
HEAD MAC 9330 89-01-17 2:58p 
HEAD REL 2048 89-01-17 2:59p O 生成され た 

オブジェクト ファイル 

14K in 3 files 443K free 
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A>180 ck, head, cl ib/s, crun/s, cend, head/n/y/e: xnain (^J O リ ン 力の 起動 
MSX.L-80 1.00 Ol-Apr-85 (c) 1981,1985 Microsoft 



Data 


0103 182E < 5931> 




36744 


Bytes Free 






[0103 


182E 24] 






A>dir 


head.* \J] 






HEAD 


C 3802 88-0 1- 


17 


2:53p 


HEAD 


MAC 9330 89 - 01- 


-17 


2:58p 


HEAD 


REL 2048 89-01- 


■17 


2:59p 


HEAD 


COM 6016 89-01- 


17 


2:59p 


HEAD 


SYM 1152 89-01- 


-17 


2:59p 


21K 


in 5 files 436K free 






A> 









o 生成され た オブジェクト ファイル 

o 実行可能 ファイル 

o シンボル テーブル フ アイ ル 



これで 実行可能な HEAD の プログラムが 生成され ました. 
ここで はリ ン 力の パラメータ などに ついては 説明し ません が， シンボル テーブル ファイル 
(.sym フ アイ ノレ） を 作成し ないよう にもで きます し， また， リンカ を 起動す る 前に アセンブラの 
ソースファイル （, mac ファイル） を 削除して しまっても， この場合 はかまわない でしよう， 
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3.1 擦 準 C (V7UNIX-C) との 霪理仕 MU: の 相逮点 

C 言語に は 現在のところ， 国際的な 工業規格の ような 意味での 「標準 c」 は 存在し ません. 多く 

の C の 処理 系 は， Kernighan & Ritchie の" The Programming Language C" 準拠， あるいは 
ANSI の 標準化 案 準拠な どと いう 形 を 取って います. ここで は， 標準 的な C の 処理 系の ひとつで 
ある， UNIX Version 7 の C (以下で は 標準 C とする） との 比較で， 説明して いきます. 

また， この 章に 含まれな いもの は， 同じ 機能 を 実現して います. すなわち， switch 文な どの 制 
御 構造， 構造体 • 共用 体， すべての 演算子な ど 言語 仕様に 含まれて いるもの はすべ て サポート さ 
れ ています. 

3,1,1 ryj プ oto サ文 による 制御 

標準 C では プリ プロセッサ 文はコ ン パイ ラの プリ プロセス 時に ソースファイル を 拡張する も 
のとして 使用され ます 力、 MSX - C では コ ンパ イラ を 制御す るた めの プリ プロセッサ 命令が 用意 
されて います. この コ ン パイ ル モー ド 制御の ための プリ プロ セッ サ文は # pragma 文で， 以下の よ 
うな 制御 を 行う ことができます. 



pragma nonrec 

デフォルト 関数 モー ド を 非 再帰 モ 一 ド に す る . 

(2) # pragma recursive 

デフォルト 関数 モード を 再帰 モードに する. 

(3) # pragma pdpllmode 

PDP-11 コ ンパチ ブル モー ドでコ ン パイ ル する. 

(4) # pragma regalo 

コード ジェネレータ 中の レジスタ 割り付け フェーズ を 起動す る. 
(d;# pragma nonregalo 

コード ジ ヱ ネ レー タ 中の レジスタ 割 り 付け フヱ ーズを 起動し ない. 

(6) # pragma optimize time 

ォブ ジヱク ト プログラムの コード 効率よ り も 速度 効率 を. 敢視 する. 

(7) # pragma optimize space 

才 ブジェク ト プログラムの 速度 効率よ り も コード 効率 を 重視す る. 
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#pragmapdpllmode 以外の 文 は， プログラム 中の 任意の 場所で 指定す る ことができます. こ 
れら について は， 以下で 詳しく 説明し ます. 



A)s«ren< と #ほ》 モード 

標準 C ではす ベての 関数 は 再帰 的に 使用す る ことができ ますが， MSX-C では 関数 を 非 再帰 的 
な ものと して 宣言す る こと もで きます. 再帰 モードの 関数と 非 再帰 モ 一ドの 関数 を 区別す るた め， 
2 つの 予約語 recursive と nonrec が 新たに 導入され ています. これらの 予約語 は 関数 モード 指定 
子と 呼ばれ， 次の 例の ように 関数 定義の 先頭に 置きます. 

nonrec nainO 
{ 

printfChellOp world¥n n ); 

} 

recursive int 
factorial (n) 
int n; 
{ 

return ((n > 1) ? n * factorial(n - 1) : I); 

} 

int nax(a 9 b) 
int a, b; 

{ 

return ((a > b) ? a ： b); 

} 

上記の 例で 定義され ている 3 つの 関数のう ち， 関数 main ( ) は 非 再帰 的 関数， 関数 factorial ( ) 
は 再帰 的 関数と して 宣言され ています. また， 3 つ 目の 関数 max ( ) は 関数 モー ド 指定 子 を 持た な 
いので， デフォルト 閼数 モード を 持つ ものと 見なされます. 

デフォルト 関数 モー ド は 通常 は recursive です が， 次の プリ プロ セッサ 文に よつ て 変更す る こ 
とがで きます. 

#pragna nonrec 
itpragna recursive 

前者 は デフ ォ ル ト 関数 モ一 ド を nonrec に， 後者 は recursive にします. 上記の 例で， 関数 max 
の 定義 以前に これらの # pragma 文が 現れて いない 場合に は， 関数 max ( ) は recursive と して 扱 
われます （デフォルト）. 現れて いる 場合に は， 関数 max() は 最も 近くで 指定され た閼数 モード 
になります. 

MSX-C では 非 再帰 的な 関数 は nonrec と 宣言す るよ う に して く ださ い. これによ つて コ ン パイ 
ラは， サイズが 小さく， 実 ネ亍 速度 も 速い オブジェクト コード を 生成す るよう になります. 通常の 
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アプリケーションプログラム では， 大部分の 関数 は 非 再帰 的な ので， ソース プログラムの 先頭に 
プリプロセッサ 文 

ttpragna nonrec 

を 置いて おく とよいで しょう. 



B)PDP-1 1 コンパチ ブ JDt "ドと MSX-C カオル トモ ード 

MSX-C では， MSX- C デフ オル トモ 一 ドか PDP-11 コ ンパチ ブル モー ドカ、 に よって， 2 種類の 
異 な つ た 算術 変換 規則が 適用 されます. 

PDP-11 コンパチブル モードで は， 標準 C と 同様の 算術 変換が 行われます. ただし， char は符 
号な しとして 扱われます. 

MSX-C デフ オル トモ" ド では, 新たな 2 つの 型， 整数 定数 型 (intconst) と 文字 定数 型 (chaixoi ト 
st) が 導入され ています. これら は 通常 は それぞれ int 型， char 型と 同じように 扱われ ますが， 変 
換 規則が 適用され る ときには 別の 型と して 扱われます. また， この モードで は char 型から int 型 
への 自動 型変換 は 行われません. 

特に 指定され ない 限り， コンパイル は MSX-C デフォルト モードで 行われます， PDP-11 コン 
バチ ブル モー ドでコ ン パイ ル する 場合に は， プロ グラ ム の 先頭で 

Ifpragna pdplloiode 

を 指定し なければ なりません. この 指定 は プログラムの 先頭で しかも プログラム 中で 1 回 だけし 
か 行 うこと がで きません. また， MSX-C デフォルト モードで コンパイル された オブジェクト コー 
ド と の 互換性が な く なる ため， PDP-11 コ ンパチ ブル モー ド を 利用す る 場合に は， 標準 ライ ブラ リ 
関数 を 含めた すべての ソースファイル を この プリ プロセッサ 命令 を 指定して コンパイルし なけれ 
ばな りません. 

MSX- C の デフォルト モー ド では， 効率の よい オブジェ ク ト コード を 生成す るた めに， バイ ト算 
術 演算 を サポート しています， これ は， char 型 （TINY, BOOL も 同じ） 同士の 演算 は ワードに 
拡張され ずに バイ 卜の ままで 行われる ため， 8 ビット プロセッサに 対してより 高速で 小さい 才ブ 
ジェ タト コードが 得られる という 重要な 特徴が あります. また ，論理演算と 関係 演算 （&&， | 
し ！， =， ！ =，>，<，>=,<=) の 結果 も char 型と なります. 

ただし， MSX-C の char 型 は 符号な しとして 扱われ， 0 から 255 まで を 表現 できるだけで すの 
で， 負になる べき 演算 や， 演算に よる オーバーフロー や アンダー フロ〜 が 起こる 場合に は， 結果 
が 正しく 反映され ません. このような場合に は， hit や unsigned に キャストして 演算 を 行うよう 
にして ください. 

MSX-C の デフォルト モード の 算術 変換 規則 を まとめて おきます. これ は 「通常の 数値 変換」 と 
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呼ばれる もので， 下の 表で， いずれ かの オペランドの 型が (1) である 場合， 他方の オペランドの 型 
が (2) に 変換され， 結果 は (3) の 型になります. なお， オペランドの 優先順位 は 表の 左の 数字が 小さ 
いほ ど， 萵 くなります. 



傻先 順位 


(1) 


(2) 


(3) 


1 


unsigned 


unsigned 


unsigned 


2 


int 


int 


llll 


3 


char 


char 


レ 1 显 C(I 


4 


intconst 


intconst 


intconst 


5 


charconst 


charconst 


charconst 


PDP-11 コンパチ モ 


― ドの 算術 変換 規則 は 次のと お り です. 


ただし， char の オペランド は— 


て int に 変換され ます. 






優先順位 


(1) 


(2) 


(3) 


1 


unsigned 


unsigned 


unsigned 


2 


int 


int 


int 



OKif 文の 非 tMt — 卜 

MSX-C では #if プリプロセッサ 文が サポートされ ていません. しかした いていの 場合に は， # 
if 文の 代わ り に # ifdef や # ifndef を 使用す る ことができる でしよう. また， MSX-C コ ン パイ ラ は 
プログラム 中で 決して 実行され る ことのない 部分に 対する コード 生成 を 行わない ので， if 文に よ 
つて # if 文と 同じ 効果 を 得る こと もで きます， たとえば 次の プログラム 例 00 は (2) のように 書き 
換える ことができます. 

(1) 

»if sizeof(FCB) 1= sizeof(char[37]) 
OpenMSXO; 

ttelse 

OpenOTHERO; 

#endif 

(2) 

if (sizeof(FCB) != sizeof(chap[37])) 
OpenMSXO; 

Q lS。 

OpenOTHERO; 

(2) の よ う に 記述す る こと で 実際に は OpenMSX ( ) ； の 行か， OpenOTHER ( ) ； の 行の どちら 
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か 一方し か コード 生成 はされ ません. 



D) コンパイラの 内 W 的な 制， 

ここで は コンパイラ による 変数の レジスタ 割り付けの 制御 や オプティマイズの 制御に ついて 説 
明し ます. 

MSX-C コ ン パイ ラ は 変数の レジスタ 割り付け をサ ポー ト している ので， 効率の 良い オブジェ 
クト コード を 生成し ます. 標準 C では， 記憶 クラス register の 変数のう ち， はじめの いくつかの 
変数 だけが レジス タ 内に 置かれ ま す. （いくつの register 変数が レジスタ 内 に 置かれる か は 機種 
に 依存す る）. それに 対して MSX-C コンパイラ は， プログラムの データ を 解析す る ことにより， 
最適な レジスタ 割り付け を 自動的に 行ないます. したがって プログラマ は， どの 変数 を register 
と 宣言す るべき か 悩む 必要が ありません. どの 変数 を レジスタに 割り当て るか は コード ジ ヱネレ 
一夕が 判断す るので， register 宣言 は 特別な 意味 を 持たず auto と 全く 同一視 されます （register 
宣言 をす る こと 自体 は 可能). 

プログラム 中の 各 関数に 対して， 記憶 クラス auto または register を 持つ もののう ち， 単純な 型 
の 変数の はじめの 16 個が， レジスタ 割り付けの 候補と なります. ここで 単純な 型と は， int， 
char, unsigned と ポインタ のこと です. 

C では 変数の ァ ドレス を 取り出す という こ とがで きます が， レジスタ 割り付けの 対象と なる 変 
数の 場合に は 問題が 出て きます. なぜなら， レジスタの" アドレス" という もの は 存在し ないか 
ら です. 

例えば， 

1: int n; 
2： 

3： n = 10； 

4: scanf ("！ W", 

5： printfOSd", n); 

という プログラムで， 4 行 目で 100 が 入力され ると， 変数 n に は 100 力ぶ 代入され ます. コンパ ィ ラ 
は， ある 変数に 対して アドレスが とられる と （4 行 目）， プログラム 中の その 文脈の 前後で は その 
変数の 値 を レジスタ ではなく メモリに 置く ようにし ます. したがって 関数の パラメータ として 変 
数の アドレス を 渡す という 場合に は 値 は メモリ に 置かれる ため， レジスタ 割り付け によって 起こ 
る 問題はありません. 
ここで， 次の ような プログラム を 考えて みる ことにしましょう. 
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1* ^include <stdio.h> 

2： ^pragma nonrec 
3： 

4: nainO 

5： { 

6： int n; 

7： int *p; 

8： 

9： p = &n; 

10: n = 10； 

11: *P = 100； 

12： printf( w n = Xd¥n w , n); 

13： } 



この プログラムの 場合， 12 行 目で 表示され る n の 値 は， 100 でなければ なりません. ところが 実 
際に コンパイルして 実行して みると， ，，n = 10" と 表示され てし まいます. つまり， p によって 間接 
的に n の メモリ 上の 位置 を 参照して その 内容 を 100 に 変更して いるに も 関わらず， n の 値 は 10 の 
ままに なって いる わけです. この 原因 を 探る ため， 生成され た アセンブリ 言語の リスト を 見て み 
ましょう. 



MSX-C ver 1.20x 、code generator) 



？ 26： 



naino: 



cseg 

defb 
dseg 
defs 
cseg 



Id 
Id 
Id 

inc 
Id 

push 
Id 

push 
Id 

call 

POP 

pop 
ret 



110,32,61,32,37,100,10,0 
2 



h し？ 26 
de,10 
(hi), 100 
hi 

(hl),0 
de 

bc,?59999 
be 

hi, 2 
printf 
be 
be 



public nainO 
extm printf 



end 



0123456789 

2 2 2 2 2 2 2 2 2 2 
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この リス ト から わかる ように， n の 値が レジスタ DE と メモリ （HL で 指されて いる） の 両方に 
とられて います. 13 行 目から 15 行 目で メモリ 中の n の 値が 100 にされ ている のです 力、 コ ン パイ 
ラは それ を 無視して， レジスタ DE の 値 を n の 値と して プッシュし， printf () に 渡して います. 
したがって， "n = 10" として 表示され てし まった わけです. 

これ は， 前述の ように 「レジスタの アドレス」 という ものが 存在し ないた めに 起こった 副作用 
です. しかし このような 例 はまれで あり， 他の 表現に 書き かえる ことができ ますが， もし どうし 
て もこの ような こと を やりたい ので あれば， レジスタへの 自動 割り付け を 禁止し， すべての 変数 
を メモリに 置く ように 指定し なければ なりません. そのために は 

#pragna noregalo 

を レジスタ 割り付け を 禁止したい 関数の 前に， そして 
ttprctg 塑& regal o 

を 関数の 後に 付けて コンパイルして 下さい. この 指定が あると， レジスタ 割り付け を 行う 場合に 
比べて 効率 は 若干 低下し ますが， コ ン パイ ラ は その 関数の 中の すべての 変数 を メモリ に 置きます 
ので， 上の 例もう まく 処理され ます. 

また， コ ンバ イラの ォプ ティ マイ ズの 制御 を ユーザーが 行う ことができ， そのために は 次の 2 つ 
の プリ プロセッサ 文 を 使用し ます. 

Spragia optimize time 
Kpragna optimize space 

前者 は オブジェクト プログラムの 速度 効率 を 重視した 指定です. つまり， 多少 オブジェクト プ 
ログ ラムが 大きくな つても， 実行 速度 を 速く したい 場合に 指定し ます. 

後者 は ォブジ ヱクト プログラムの サイズ を 重視した 指定です. つまり， 多少 実 《ラ速 度が 遅くな 
つても， オブジェ ク 卜 プログラムの サイズ を 小さ く したい 場合に 指定し ます. 

これ はたと えば， ユーザーからの キー入力 要求な どと いった， 速度 を 無視して よい 部分で は 後 
者， ループ や 数値 演算 を 多用して いる 部分で は 前者 を 使用 するとい うように， 適宜 使い分ける こ 
とに よって 効率が 向上し ます， 
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3.1. a 瞧 の宣霣 



A) 暗黙の 直 雷 

標準 C では， 宣言され ていない 関数が 現れた 時には それ は 『int 型 を 返す 関数 J であると 仮定 さ 
れ， パラメータ リス 卜に あるが 宣言され ていない パラメータ は int 型で あると 仮定され ます （暗黙 
の 宣言). しかしながら： VISX-C では， 「すべての 識別子 を 使用す る 以前に 必ず 宣言 をす る J とい 
う 良い プロ グラ ミ ング スタイル を 推奨す るた めに， これらの 暗黙の 宣言が 行なわれない ようにな 
つてい ます. 

すべての 標準 ライ ブラ リ 関数に 関する 宣言 は， ヘッダ ファイル stdio.h などに 含まれて いるの 
で， いちいち 宣言し なくと も 使用す る ことができます. そのため， すべての ユーザ一 プログラム 
は， 胃 頭で へ ッダ ファイル stdio.h を # include によって インクルード しな ければ な りません. 

し か し バーサ （CF) で- f ォ プショ ンを 指定す る ことによって これら の 暗黙の 宣言が 行なわれる 
ようにな るので， 標準 C との 互換性 を 保つ ことができます. 



B) 可变バ ラメ"^ B 数と 固 ラメ"^ H 数 

MSX-C に は 可変 パラ メータ 関数と 固定 バラ メータ 関数と いう 2 種類の 関数 種別が あ ります. 
前者 はパ ラメ一 タ の 数 や 型が 可変な 関数で， 後者 は パラメータ の 数 と 型が 固定 されて いる 関数で， 
これ は MSX-C で 新たに 導入され た 概念です. この 区分に 従う と， 標準 C の 関数 はすべ て， 本質 
的に は 可変 パラメータ 関数です. MSX- C の 場合で も， たとえば printf ()， scanf() など は 可変 
パラメータ 関数の 例です. 

MSX-C で 固定 バラ メータ 関数と いう 概念が 導入され たの は， その ォブ ジヱク ト 効率の 良さ か 
ら です. つまり， 可変 パラメータ 関数が そのす ベての パラメータの 受渡しに スタック を 使用す る 
のに 対し， 固定 パラメータ 関数 は 最初の 3 つの パラメータ を レジスタに 入れて 渡す ために， 効率 
が 大きく 向上し ます. 

MSX-C では 標準 C と 同様の 関数 宣言 は， すべて 固定 パラメータ 関数の 宣言と 見なされます， 
標準 C の 関数 は 可変 パラメータ 関数です が， 実際に は ほとんどの 関数 は 固定 パラメータ であるた 
め， 互換性の 問題 は 生じません. 

一方， 可変 パラメータ 関数 は （主に パラメータの アクセス 方法が） ターゲット マシンに 依存す 
るた めに， 移植性が ありません （移植性が な いのは 可変 パラメータ 関数 自身で あり， それ を 呼び 
出す 側の 鬨数は 移植 可能). 



C) 可変 パラメ"^ B 数の 定義 

可変 バラ メータ 関数と 固定 パラメータ 閧数を 区別す るた め， MSX-C では 宣言 子 （declarator) 
と 抽象 宣言 子 （abstract declarator) の 構文 は 次のように なって います. 
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宣言 子： 
識別子 
(宣言 子） 
* 宣言 子 

宣言 子 0 

宣言 子 （- ) 

宣言 子 [定数 式 opt] 

抽象 宣言 子 ： 
空 

(抽象 宣言 子） 
* 抽象 宣言 子 
抽象 宣言 子 0 

抽象 宣言 子 （- ) 

抽象 宣言 子 [定数 式 opt] 

『宣言 子 し ）』 と 『抽象 宣言 子 し ）』 力 河 変 パラメータ 関数 を 表わす ために 新たに 追加され 
ています. これに 対して， 従来の 記法 『宣言 子 （)J と 「抽象 宣言 子 （)J は， 固定 パラメータ 関 
数 を 示します. 

このような 可変 パラメータ 関数の 記法 は， 宣言， キャスト， sizeof (型） の 場合に 使われます， た 
とえば 次の 宣言 は， 可変 バラ メータ 関数 func () と 可変 バラ メータ 関数への ボイ ンタ fp を 定義し 
ています. 

int func(. ), (*fp)(. ); 

可変 パラメータ 関数 を 使用す る 前に は， このような 宣言 をし なければ なりません. 標準 ライブ 
ラリ 関数のう ち， 

exec 10, execlpO, fopen() 
printfO, fprintfO, sprintfO 
scanfO, fscanfO, sscanf() 

は， 可変 バラ メータ 関数です. しかし これらの 関数に 対する 宣言 は ヘッダ ファイル stdio.h と 
string.h に 含まれて おり， しかも 可変 バラ メータ 関数の 呼び出し は 固定 バラ メータ 関数の 場合と 
まったく 同じな ので， 可変 パラメ ^"タ 関数 を 0 分で は 書かない ユーザー は 標準 ライ ブラ リ 関数 を 
意識せ ずに 使う ことができます. 
次に， 実際の 可変 パラメータ 関数の 書き方 を 説明し ます. 

まず 関数 本体の 定義の 前に， その 関数が 可変 パラメータ である こと を 示す 宣言 をし なければ な 
りません. 可変 パラメータ 関数 化 nc () の 典型的な 定義 は 次の よう にな ります. 
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int func(. )； /* 必ず この 宣言 をし なくて はならない %1 

int func(nargs, args) 
int nargs, args; 
{ 

} 

上の 例で は， 関数 func () は 本体 定義の 前に 可変 パラメータ であると 宣言され ています. もし, 
宣言 

int func(. )； 

を 忘れた 場合に は， func () は nargs と args という 2 つの int 型の パラメータ を 持つ 固定 パラメ 
ータ 関数に なって しまいます. 

可変 バラ メータ 関数 を 呼び出す と， 実際の パラメータの ほかに， もう ひとつの 暗黙の パラメ 一 
タが 渡されます. この パラメータ は nargs と 呼ばれ， 実際の パラメータの 個数 を 値と して 持って 
います， nargs によって， 可変 バラ メータ 関数 は 実際にい くつの パラメータが 呼び出し 側から 渡さ 
れ たかを 知る ことができます. また， 可変 パラメータ 関数の 側で 知る ことので きる の は 渡された 
パラメータの 数 だけで あり， それぞれの バラ メータの 型 を 知る こと はでき ません. 

呼び出し 側に よって 渡された 実 パラメータ を アクセス する ために， も う ひとつの パラメータ 
args を 宣言し ます. 1 番目の パラメータ （もし 存在す るなら ば） は， args と 同じ アドレスに 入り 
ます. すなわち， 1 番目の バラ メータ は args そのものと なります， 2 番目 以降の パラメータ は， 
ァ ドレスが 增 える 方向に 向かって メモリ 上に 順に 格納され ます. つまり 2 番目の バラ メータ は 

〔args の アドレス +2〕 番地に， 3 番目の パラメータ は 〔args の アドレス +4〕 番地に というよう 
に， それぞれ 格納され ます. 

バラ メータの 格納され る アドレス は 次の 表の ようにして 計算で きます. 



実 バラ メータ 


アドレス 


1 番目 


args のァ ドレス 


2 番目 


args の アドレス +2 


3 番目 


args のァ ドレス +4 


n 畨目 


args のァ ドレス + (11-1) * 2 



実 パラメータ は， 上の 表に 示した アドレス によって アクセス する ことができます. たとえば， 

1 番目と 2 番目の バラ メータ を それぞれ char として 参照す るに は， 次のように します. 

(char) args ： 1 番目の パラメータ を char として 参照す る 

(char) * (&args + 1) ： 2 番目の パラメータ を char として 参照す る 
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この 例で は， args は int 型で あると 宣言され ている ので， &args は， 『int 型への ポインタ J に 
なります. したがって， &args+l という 式に おいて， 定数 1 は sizeof(int *) 倍 （つまり 2 倍） 
され， 〔args の アドレス +2〕 番地が 参照され ます. 同様にして， 他の 型の パラメータ も アクセス 
する ことができます， 



ここで 簡単な 可変 パラメータ 閧 数の 例 を 2 つ 示しましょう. 関数 sum() は （可変 個の） int 型 
パラメータの 和 を 値と して 返します. 関数 cmax は， 可変 個の TINY(char) 型の パラメータのう 
ち 最大の もの を 返します， 



tpragna nonrec 
typedef char TINY; 

int sua(, )； 
TINY cmax(. )； 

int sun(nargs, args) 
int nargs, args; 
{ 

int i, *p; 

for (i = 0, p = foirg が nargs—;) 

i += *p++; 
return (i); 

} 

TINY cinaxCnargs, args) 
int nargs; 
TINY args; 
{ 

int *p; 
TINY nax; 

fop (nax = 0, p = (int^O&args; nargs—; p++) 
if (nax < (TINY)*p) 

nax = (TINY)*p; 

return (max); 

} 



他の 可変 パラメータ 関数の 例と して は， 標準 ライブラリ 関数 printf ()， scanf ()， fopen() な 
どが 挙げられます. 
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3.1.3 その他 



AJfloat double, long の 非 « — 卜 

MSX-C では， 現在のところ float 型， double 型， long 型が サポートされ ていません. しか 
し， 標準 C との 互換性 を 保った め， これらの 識別子 は 予約語と なって おり， ユーザーが 変数 名と 
して 使 ffl する こと はでき ません. 



B) ビット フィールドの 非 thlt —ト 

構造体と 共用 体の ビッ トフィー ルド は サポートされ ていません. 適切な ビッ ト ごとの 論理演算 
で 置き換える 必要が あります. 



G) 定数 式の 制 陋 

次の 場所に く る 定数 式に は， sizeof 単項 演算子 を 含める こ と はでき ません， 

(1) case の 直後 （case の ラベルと して） 

(2) 配列 宣言での 配列の 大 き さ の 定義 

ただし， 変数の 初期化 要素 中の 定数 式に はこの ような 制限はありません. この 制限 は， 中間 言 
語 （T コード） を ターゲット マシンの ハードウェアに 依存し ないように する ために 設けられ たも 
のです. 



D) 構 進 体， 共用 体の メンバ 名 

MSX-C では， 同じ メンバ 名 を 異なる 構造体 や 共用 体に 対して 使用す る ことができます. つま 
り， 構造体と 共用 体の メンバ 名の 有効 範囲が 標準 的な C と 異なって いるので す. 標準 的な C では 
同じ メンバ 名 2 つ 以上の 別々 な 構造体 や 共用 体に 使用す る ことができ るの は， それらの オフ セッ 
ト と 型が 等しい 時に 限られて います. 
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たとえば， 次の 宣言に ついて 考えて みましょう. 

struct node { 

char *word; 

int count; 

struct node *next; 
} pool [麵] ,*p; 

struct noad { 

int atr; 

struct noad *next; 
} table [10]， *q; 

標準 C では， このような 宣言 は 正しくありません. なぜならば， メンノ 《名 next が 2 つの 構造体 
node と noad に 現れる にもかかわらず， それらの 型と オフセットが一 致して いない からです. し 
かし， MSX-C では この 宣言 は 正しい 宣言です. 

P や next 

が struct node 型の メ ンバを 表すと いう ことに 注; ® して 下さい （p は struct node 型への ポィ ンタ 
であるた め）. このように， 構造体の メンバが より 厳格に 型 付けされ ている ので， 正しい メンバ を 
選択す る ことができます. つまり，"." 演算子 や" >" 演算子の 左側に は， 右側の メンバ を 含む 
構造体 そのもの やそれ への ボイ ンタが こなければ なりません. 

なお， 異なる 構造体 や 共用 体で 同じ 名前の メ ンバが 使用で きる というの は MSX-C 特有の 拡張 
ではなく， 新しい C コンパイラの ほぼ 共通した 特徴で あるた め， これによ つて 互換性が 損なわれ 
る こと は ほとんどありません. 



E) ポインタ， 《» 画の 相互 代入 

ポインタと 整数の 間で は， キャスト を 使わない かぎり 演算 を 行う こと はでき ません. また， ポ 
インタ 同士の 演算で も それらの ポインタが 異なる 型 を 指す 場合 は， や は り キャスト が 必要 に な り 
ます. 

たとえば， 

int i; 
char *p; 
int *q; 

という 宣言の もとで， 次の 4 つの 文 は， いずれも エラー 扱いと なります. 
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はじめの 2 つ は， ポインタと 整数の 間の 代入 '比較です ので エラーと なります. また， 後の 2 つ 
は， p も q も ボイ ンタ ではあります 力、 その ポィ ンタの 指して いる 型が 異なって いますので， 同様 
に エラーと なります. この エラ一 は， キャスト を 付ける 力、， バーサ （CF) に対して- 1 オプション 
を 指定す る ことにより 避ける ことができます. キャスト で 解決す る 場合に は 例 え ば 次の ように な 
ります. 

p = (char 

if (p == (char *)i) .，. ； 

q = (int *)p; 

if (p == (char *)q) ... ； 

一方， 整 定数と ポインタ 間の 型変換 は 許されて います. なぜなら， C では 『どこも 指して いな レ、 
ポインタ』 として 定数 0 (NULL) を 使う という 慣習が あるから です. 
例えば， 

char *p; 
if (p != 0) 

P = 0； 

は エラーと はなり ません， 

このように， MSX- C では int 型と ボイ ンタ との 混用 は 許されて いません. これ は 型に 対して ル 
ーズな プログラム を 書く 人に は 面倒な ことのよ うに 思える かもしれ ません. しかし， 型 チェック 
を きびしく おこなう こと は プロ グラ ミ ング スタイル として 推奨すべき ことで ありこれ によって， 
プログラムの バグ を 少な く する こ とがで きます. 




- t 一 

i p p P 
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3.2 アセンブリ BB との リンク 

アセンブリ 言語との リンク を 考える 場合に は， はじめに MSX-C の 言語 仕様， ハードウェア 特 
性 を 頭に 入れて お く 必要が あ ります. 特に， データ 長 や データの 格納 順が 問題に な り ます. 

16 ビッ 卜 長の データタイプ では， 下位 バイ トが 初めに ストアされ， 次の 番地に 上位 バイ トがス 
トァ されます. つまり， 16 ビット 長 データの 内部 表現 は 8080 系の 標準 的な データ 表現と 同じで 
す. また， データ 長に ついては 下の 表のと おりで あり， 次の 点に 注意して ください. 

•MSX - C では， ポインタ は 16 ビット 長で あり， したがって int 型と 同じ 長さ を 持つ 
•short 型と int 型 は， まったく 同一の ものと して 扱われる 



表 基本 データ 型の 長さと 範囲 



型 


長さ 


範囲 


char 


8 


0 〜 


255 


short 


16 


-32768 〜 


32767 


int 


16 


-32768 〜 


32767 


unsigned 


16 


0 〜 


65535 



3,5,1 バラ メータの 渡し 方 

アセンブラへの パラメータの 渡し 方 は， 固定 バラ メータ 関数の 場合と 可変 パラメータ 関数の 場 
合で それぞれ 異なって います. 

まず， 通常の 関数 （固定 パラメータ 関数） の 場合， はじめの 3 つの パラメータ は レジスタに 置 
かれ， 4 番目 以降の バラ メータ は スタックに 積まれて 渡されます. 1 番目の パラメータ は char 型 
の 場合に は A レジスタに 置かれ， それ 以外なら ば HL レジスタ ペアに 入れられます. 2 番目の パ 
ラメ一 タは char 型の 場合 E レジスタに， それ 以外なら ば DE レジスタ ベアに 置かれます. 3 番 H 
の バラ メータ は char 型の 場合 C レジスタに， それ 以外なら ば BC レジスタ ペアに 置かれます. 4 
番 H 以降の バラ メータ は， スタック 上に 逆順に 積まれます. さらに， スタックの 先頭に は 戻り 番 
地が 積まれます. スタック 上に 置かれる パラメータ はすべ て 2 バイ ト 長です. char 塑の パラメ一 
タの 場合に は 値 は 下位 バイ 卜に 入り， 上位 バイ 卜の 値 は 使用され ません. 

PDP-11 コンパチ モードが 指定され ている 時には， char 型の バラ メータの 扱いが 異なります. 
この モードで は， char 型の バラ メータ は int 型に 自動的に 変換され (上位 バイ トは 0 になる）， 他 
の 型と 同じ 扱い を 受けます. 

これらの 規則 を まとめる と， 次の 表の ようになります. 
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表 パラメータの 渡し 方 （固定 パラメータ 関数) 



ハ°ラ メータ 


1 番 H 


2 番目 


3 番目 


4 番目 


5 番 H 




n 番目 （n〉3) 


char S! 


A 


E 


C 


(SP + 2) 


(SP+4) 




(SP+2n - 6) 


その他の 型 


HL 


DE 


BC 


C<l CO 
_1_ _|_ 
卞 "T 

O) の 


(SP+4) 
(SP+5) 




(SP+2n-6) 
(SP+2n-5) 



注意 I PDP-11 コンパチ モードで は， char 型の パラメータ は 自動的に int 型に 変換され 他の 型と 同じ も 



のとして 扱われる. 



I 例 I 

関数 呼び出し 

sub(，A，， OxABCD, 10， ，0，, -3)； 

によって， パラメータ は 次のように 設定され ます. 





デフォルト 
モード 


PDP-11 
コンパチ モード 


A 


41H 




B 


O0H 


O0H 


C 


0AH 


0AH 


D 


ABH 


ABH 


E 


CDH 


CDH 


H 




O0H 


し 




41H 


(SP+2) 


00H 


00H 


(SP + 3) 




00H 


(SP + 4) 


FDH 


FDH 


(SP + 5) 


FFH 


FFH 



一方， 可変 バラ メータ 関数の 場合に はこれ と は 異な つ た 値の 受渡 し が 行われ ま す. 

可変 パラメータ 関数が 呼び出される 時には， すべての パラメータ は スタック 上に 逆順に 積まれ 

ます. そして スタックの 先頭に は 戻り 番地が 積まれます. HL レジスタ ペアに は， パラメータの 個 
数が 入って います. おのおのの パラメータ は 2 バイ ト を 占めます. MSX-C の デフォルト モー ドで 
は char 型の パラメータ は 下位 バイ トに 置かれ， 上位 バイ トの値 は 不定で， 使用され ません. PDP 
-11 コンパチ モー ド では， char 型の パラメータ は 自動的に int 型へ と 変換され ます （この 際に 上位 
バイ 卜 は 0 が 入れられます）. 他の 型の バラ メータ は， 8080 系 プロセッサの 標準 的な 規則 （つま 
り， 下位 バイトが 先に ストアされ， その 次に 上位 バイトが ストア される） に 従って 納められ てい 
ます. 
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可変 パラメータ 関数と リンクす るた めに は， あらかじめ， 

int sub(. )； 

のよう な 宣言 をし なければ なりません. 
これらの 規則 を まとめる と， 次の 表の ようになります. 



表 パラメータの 渡し 方 （可変 パラメータ 関数) 



パラメータ 


nargs 


1 番目 


2 番目 


3 番目 




n 番目 


char 型 


HL 


(SP+2) 


(SP+4) 


(SP + 6) 




(SP+2n) 


その他の 型 


HL 


(SP+2) 
(SP+3) 


(SP+4) 
(SP+5) 


(SP + 6) 
(SP + 7) 




(SP+2n) 
(SP+2n+l) 



[洤^ J PDP-11 コンパチ モードで は， char 型の パラメータ は 白 動的に int 型に 変換され， その他の 型と 
同じ ものと して 扱われます， 



関数 呼び出し 

sub(l. ，A，， -3)； 

によって， パラメータ は 次に 示す ように 設定され ます. ただし， あらかじめ 

int sub(. )； 
という 宣言が されて いるものと 仮定し ます， 





デフォルト 
モード 


PDP-11 
コ ンパチ モー ド 


H 


00H 


00H 


L 


0311 


03H 


(SP+2) 


01H 


01 H 


(SPH-3) 


00H 


00H 


(SP + 4) 


4111 


41H 


(SP + 5) 




0OH 


(SP+6) 


FDH 


FDH 


(SP+7) 


FFII 


FFH 
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3-2,2 儘の 返し 方 

関数から 呼び出 し 側に 戻る ときに レジスタ に 値 を 入れる ことによって， 関数 値 を 返す こ と がで 

きます. 関数の 返す 型が char 型で あれば 値 は A レジスタに 入れられ， そ の 他の 場合に は HL レジ 
スタ ペアに 値 を 返します. しかし， PDP-11 コンパチ モー ド では 関数の 返す 型に かかわらず， 常に 
HL レジスタ ペア に 値を戾 します. 2 つ 以上の 値 を 返す 場合に は， 通常の C プログラムで 行なわれ 
るよう に 変数への ポィ ンタを パラメータ と して 渡して 下さい. 

3.2.3 アセンブラ， C の ルーチンの 相互 呼び出し 

アセンブラと c の 間で ルーチンの 呼び出し を 行う 場合に， 関数の 呼び出し 側と その 開 数から 呼 
び 出される サブルーチン は， それぞれ 以下に 述べられる 規則に 従わなくて はなり ません. パラメ 
ータの 渡し 方の 規則 （関数への パラメータの 渡し 方と 関数からの 値の 返し 方） について は， これ 
までの 記述 を 参照して ください. 



A) 呼び出 Uff の醒 

(1) まず， 呼び出し 側 はおのお のの バラ メータ を 評価し， それら を レジスタに 入れる か あるいは 

スタックに 積みます. パラメータが レジスタに おかれる か スタックに 積まれる か は， 「3.2.1 
パラメータの 渡し 方」 を 参照して 下さい. 

(2) 次に， 呼び出し 側 は 実際に 関数 を 呼び出します * 通常 CALL 命令が 使われます. 

(3) 関数から 戻って きたら， スタックの つじつま を 合わせる ために スタック 上に 積まれた パラメ 
ータを 捨てます （POP 命令 を 使う）， すべての パラメータが レジスタに 割り付けられ ている 場 
合に は， 何もす る 必要はありません. また， POP する 際に は HL レジスタ ペア または A レジ 
スタに 返される 関数 値 を 壊さない ように 注意が 必要です. 

(4) これで 関数の 戻り 値が （もし あれば） HL レジスタ ペア か A レジスタに 得られて います. ど 
ちらの レジスタに 値が 戻って くる か は， 前節までに 述べられ ています. 



B), び 出される RI 数 侧の鹏 

呼び出される 関数 は， スタックポインタ （SP) の 値 を 壊して はいけ ません. 言い かえると， 関 

数に 入って きた 時と 関数から 抜け出す 時と では， スタックポインタの 値が 等しくなければ なり ま 

せん， スタックに 積まれた パラメータ （もし 積まれて いれば） を POP する （捨てる） の は 呼び出 

し 側の 責任です. 呼び出された 関数 は， バラ メータ （レジスタに 置かれた もの， スタックに 積ま 
れ たもの のど ちらで も） の 値 を 変える ことができます. 

しかしながら， C 言語の 関数 間での パラメータの 受渡し は 値の コピーに よる 受渡しな ので， 仮パ 
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ラ メータの 値 を 変えても 実 バラ メータの 値 は 全く 影響 を 受けない ことに 注意して 下さい. 

関数の 値 は， 関数の 返す 型に 応じて HL レジスタ ペア か A レジスタに 入れられます. どちらの 
レジスタが 使用され るか は， 前節まで を 参照して 下さい. 



「例 1 I C 言語から アセンブリ ルーチン を 呼び出す 場合 

この 例で は， アセンブリ ルーチン isdigit@ は BOOL (char) 型 を 返す 関数と して 宣言され てい 
るので， 関数の 値 は A レジスタに 返されます. 呼び出し 側の example () は， char 型の パラメ 一 
タ c を A レジスタ に 入れて isdigit @ を 呼び出 します. 

• 呼び出し 側 （C 言語） 



typedef char BOOL; /* BOOL 型 を char と定莪 する */ 

exanpleO 

{ 

BOOL isdigitO; 
chdr c; 



if (isdigit(c)) 



} 



• 呼び出される 関数 （アセンブリ 言語) 



public isdigitO 

isdigito: 

cp '0， 

jr c, false 

cp 

ret c 

false: 

xor a 
ret 



； if less than '0* then 
； return FALSE 

； if less than or equal to '9， then 
； return TRUE 

； otherwise 

； return FALSE 



例 2l アセンブリ ルーチンから C の 関数 を 呼び出す 場合 



この 例で は， 標準 ライ ブラ リ 関数 printf ( ) と puts () が アセンブリ ル一 チンから 呼び出されて 
います. ここで は printf ( ) と puts () について は 述べません が， prin ぱ ( ) は 可変 パラメータ 関数 
なので， パラメータ は スタックに 積まれる という ことに 注意して ください. 

この 例で は パラメータ は 1 つのみ です が， 2 つ 以上の バラ メータが ある 時には， それら は 逆順 
(右から 左の パラメータの 順） に スタックに 積まれます， また， バラ メータの 数 は HL レジスタ 
ペアに 入れられます. （この 例で は， 1 力く HL レジスタ ペアに 入れられます）. printf () から 戻って 



58 



第 3: ゆ'： MSX-C による プログラミング 



きた 後に， pop が 1 度 だけ 行なわれます. これ は， 先程 スタックに 積んだ パラメータ を 捨てる ため 
です. パラメータ を スタックから 捨てる の は， 呼び出し 側の 責任です， 

一方， puts () は パラメータの 個数と 型が 一定な 固定 パラメータ 関数です. 文字列の アドレス 
が， HL レジスタ ペアに 渡されて います. 



example: 



extrn 


printfe 




extrn 


puts© 




Id 


hi, nsg 


； push address of string 


push 


hi 




Id 


h し 1 


； load t of paraneters 


call 


printfo 


； formatted output routine 


POP 


hi 


； pop the parameter off the stack 


Id 


hhnisg 


； load address of string 


jp 


PUtS@ 


； string output routine 


defb 


'Hello, world\0ah, 0 



フ アイ ル名 を exaniple.rel とすると リンク は 次のようになります. 
A> 1 80 examp le,clib/s, crun/s, cend , exaup I e/n/y/e ： exanp 1 

3-S.4 鹏！] 子の 有効 文 宇 数 

識別子の 名前と して， 他の モジュール に対して 有効になる の は 先頭から 6 文字まで です. MSX 
-C では， コード ジェネレータ （CG) で- 1 オプション を 指定す ると 6 文字 を 超える シンボル 名もァ 
セン ブラの ソースコード として 出力され ますが， 実際に アセンブラから リ ン 力に 渡される ときに 
は 6 文字 を 超え る 部分 は 切 り 捨てられて しまいます. したがつ て 6 文字 ま でで 一意 的に 識別で き 
る 識別子 名 を 使用し なければ なりません. 

標準 ラ ィ ブラ リ では， fclose ( ) と fcloseall ( ) の 区別 をへ ッ ダ ファイル stdio.h 内の # define で 
行って います. 2 つの 関数 は" fclose" までです でに 6 文字です から， そのまま リンカに 渡される と 
どちらも "FCLOSE" になって しま レ \ バグの 原因 ともなって しまいます. そこで f c l osea ll ( ) の 方 
の アセンブラ， リンカに 渡される 名前 を 別の ものにし ています. パーザ （ CF ) では， 大文字. 小 
文字の 区別， 7 文字 以上の 識別 をして いるので この ことができます. 
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3,2,5 外部 シン 抑レ 

アセンブリ ルーチンと c の ルーチンと は それぞれ 別の モジュール となる ため， 互いの モジ ユー 
ル 中の グローバル シンボル を 使用す る 場合に は， 外部 シンボル 使用の ための 宣言 を 行う 必要が あ 
ります. 

具体的に は， アセンブリ ルーチン 中で C の シンボル を 使用す る 場合に は extrn などの 宣言 を 行 
います. また， 他の ルーチンからの 参照 を 許す グローバル シンボルに ついては public 宣言 を 行い 
ます. 

なお， C と アセンブラの リンク を 行う 場合に は C の 外部 シンボル 名の 後に，， @ "が 必要です （前 
揭の例 を 参照). また， アンダースコア （，し"） も" @ "に 置き換えられ ますので， たとえば" main" 
は" main@ "として， " exit" は" @exit@ "として 参照し なければ なりません. 



3,3 欏準 C の ソースファイルの 移攛 について 

現在 C 言語 を 学習す るた めの 多くの 書籍が 発行され ています. しかし， それら は UNIX 上で 動 
作す る もの や， MS-DOS 上で 動作す る C の 処理 系 を 対象と した ものが 多い ようです. この 節で 
は， それらの 書籍に ある プログラム を， MSX-C で 正常に 動作させる ために 必要な 項目 を あげてい 
きます. 

3,3,1 バックスラッシュへ" 

バックス ラッ シュは UNIX で， コマンド ライン や C の ソースファイル などで 使われる エス ケ 
—プ 文字です. エスケープ 文字 を 使う ことで， 限られた 文字 セットで より 多くの 文字 を 表現す る 
ことができます. です が， この 文字 は JIS の 8 ビッ 卜 コードで は 定義され ていません. JIS では そ 
の 代わ り に 円記号" ¥ "が 定義 されて います， 

K&R の 「プログラミング 言語 C」 は UNIX の 環境が ある こと を 想定され ており， C 言語の 記 
述部 分に バックスラッシュが 多く 使われて います. これと同じ 事 を MSX-C です るに は" \ "の 代 
わりに" ¥ "を 使って 記述 すれば いいこと になります. つまり， 改行 文字 を 表して いる" \n "は" ¥n" 
と 記述し ます. 以下の 対応 を 参照して 下さい. 

，，\n" "¥n" 
"\ビ "¥t" 
"\0" "¥0" 
"\\" "¥¥" 

バックスラッシュの 代わりに 円記号 を 使う の は， MSX-C だけで はあり ません. JIS の 8 ビッ ト 
文字 セッ トを 使って いる コンピュータ では， 言語に かかわらず すべて 置き換える 必要が あります. 
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3.3,2 ff include <stdio,h> 

UNIX 上で 動作す る C コンパ ィ ラ では， その ソースファイル 中に ない 関数に ついては 標準の ラ 
イブ ラリを 使用す る こと を 意味して います. つまり， 外部 （extern) に 存在 するとい う 扱い を さ 
れ ます. しかし， MSX-C では コンパイル 時点で 宣言がない と， エラーが 発生して しまい， それ 以 
降の 処理が 続けられません. そのために MSX-C で プログラム を 作成す る 際 は 必ず プログラムの 
先頭で へ ッダ ファイル stdio.h を インクルード する 必要が あ ります. 

# include <stdio.h> 

... /* プログラム を 普通に 畨く */ 



3-3.3 char 型と int 型 

標準 C では char 型と int 型 は 演算， 引数と して 関数 を 呼び出す ときな ど， その 区別 を まったく 
する 必要はありません. しかし， iMSX-C では 8 ビッ ト CPU の 特徴 を 生かす ために， char 型と int 
型の 区別 を 厳格に 行って います. 特に 関数に 引数 を 渡す ときの 第 1 引数 は 重要です. それ は， char 
型と int 型で 値 を 渡す レジスタが まったく 別の もの だからです. これにつ いての 詳細な 内容 は 「3. 
2.1 パラメータの 渡し 方 j を 参照して 下さい. ここで は， どう すれば 問題が 解決され るか を 説明 
します. まず， 問題と なる C 言語の プログラム を 見て 下さい， 

nainO 

( /* 一般的な C のた めの プログラム */ 
int c; 

while ((c = getcharO) != EOF) 
putchar(c); 

} 

この プログラム は 標準入力からの 入力 を， 標準出力に 出力す る プログラムです. 一見， 問題が な 
いように 思えます 力、 大きな 落し穴が あります. それ は， 標準出力に 文字 を 出力す る 関数 putchar 
() です. この 関数の 第 1 引数 は char 型で なければ なりません. しかし この プログラム では， int 
型の 変数で ある c を， そのまま 引数と して 渡して います， つまり int 型の 値 を 渡して います. 渡す 
側の レジスタと 受け取る 側の レジスタが 違う ので， このまま コンパイルして 実行しても， 何が 表 
示される のか 分かりません. MSX-C では 次のように 修正す る ことが 必要です. つまり， キャス ト 
を 使つ て int 型の 値 を char 型に 変更 します. 

^include <stdio.h> 
ualiK ジ 

{ /* MSX — C のた めの 変更 を 加えた プログラム */ 

int c; 
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while ((c = getcharO) != EOF) 
putchar((char)c); 

} 

変更 点 は putchar 0 の 引数が" c" だけだった もの 力、 "(char)c" になった 点です. 

このような 種類 （引数の 型が 合って いない） の ミス は， FPC コマンド によって 確実に 取り除く こ 
とがで きます. 

3,3.4 可変 八 ラメ 数への 引数 

可変 パラメータ 関数 は， 関数に 渡す 引数の 数が 定まって いない 関数です. 可変 バラ メータ 関数 

の 代表的な もの は printf () でしよう. この printf ( ) では char 型の 文字 や 変数の キャラ ク タコー 
ドを 表示しょう とすると， 予期す る ものと 違う ものが 表示され てし まう ことがあります. 問題の 
ソース は 次の ような ものです. 

nainO 

{ /* 一般的な C のた めの プログラム */ 
char c; 

c = ，A，； 

printf ("Char code of ，A， is c); 

} 

この プログラム では， 文字" A" の キャラクタ コード を 表示しょう と しています. 実際に コンパイル 
して 実行す ると 

Char code of 'A' is 2625. 

と 表示され てし まいます. （数値 2625 は 機種に よって 違う ことがあります.） 2625 という 値 は キヤ 
ラ クタ コードの 範网 である 0 から 255 を はみ出し ています. これ は， 次の ような 理由から 発生し 
ます. 

(1) 可変 パラメータ 関数 は 必ず int 型の サイズで 引数 を 受け取る. 

(2) char 型の 引数 を 可変 パラメータ 関数に 渡す とき は， int 型の 下位 バイト だけ を 設定し， 上位 
バイ トは 不定と なる. 

(3) printf ( ) の" ％d"， "％x" な どの 変換 文字 は int 型の 値が 引数と して 与え られ たと みる. 
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つまり， 整数 を 表示す る" ％d "の 指定で， 上位 バイ トが 不定の ため， 予期し ない 値が 表示され てい 
ました. これ は， char 型 を そのまま printf() に 渡して いるた めに 起こります， この 問題 は 次の よ 
うに プログラム を 変更す る こと で 解決で きます. 

^include <stdio.h> 
nainO 

{ /* MSX — C 用に 変更した プログラム */ 

char c; 

c - ，A，； 

printfCChar code of ，A, is %d.¥n w , (int)c); 

} 

変更 点 は， printf ( ) に 渡す 引数" c" を" (int)c" に 変更した だけです. char 型の 値 を printf ( ) など 
に 渡す とき は， 必ず そ の 値 を int 型に キャス 卜する ようにし ます. こ の 問題 は 整数 を 表示 しょうと 
している 変換 指定ぐ' ％d "など） で， char 型 を 表示した 場合の み 起きます. つまり， 文字 を 表示す 
る" ％c "の 場合に は 問題 は 起きません. また， この 問題 は， FPC コマンド では 発見で きません ので 
注意して 下さい. 



3-3,5 関数の 窗霣 （関数の 前方 参照) 

定義 や 宣言され ていない 関数が コンパイル 中に 現れる と， 標準 C は int 型 を 返す ものと して コ 
ン パイルし ま す 力、 MSX-C で は コ ン パイ ルェ ラ 一が 発生 します. つまり， 関数 を 呼び出す ときに 
は 使う 前に 必ず 宣言が 必要になります .main () が ファイルの 先頭に ある と， そこで 使われる 関数 
は main () より 先に 宣言が 必要です. これにつ いての 細かい 説明 は r l. 4. 2 c) 関数の 宣言」 を 参 
照して 下さい. 

3.4 MSX-C Ver.1,1 と Ver.l.S の 相 

ここで は Ver.l.l と Ver 丄 2 の 違いに ついて 解説し ます. 

3-4,1 コマンドの 変更 点 

(1) Ver.l,2 に 付属す る コマンド 類 は， すべて MSX- D0S2 でなければ 勦 作し ません. MSX- 
D0S1 の 場合に は" This program needs MSX-D0S2" と 表示して 終了し ます. 

(2) コンパイル や チヱ ック など をす る 対象の ファイルの 指定に ドライブ 名， パス 名， 拡張 子が 指 
定 できる ようになり ま した. コマンド によって 作成され る ファイルに ついても 同じ様に でき 
ます. 
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(3)CF， CG， MX においての"- e" や"- o" スィッチの 後の 指定 は， アルファベット 1 文字の 時と 
それに コロンが ある 時 は その ドライブに， "¥ "で 終って いる ときには それ を ディ レクト リ名 
として その ディ レク ト リに， また" ¥ "以外で 終って いる ときには それ を ファイル 名と して， 出 
力 ファイル を 作成し ます. 



A)OF 固有 点 

(1) ィ ン クルー ドフ アイ ルの デフォルトの ディレクトリ が， 環境 変数 INCLUDE に よ つ て 指定で 
きる ようになりました. これによ つて ヘッダ ファイルが あるか どうかな ど を あまり 意識し な 
くても いいようになります. そのため， ヘッダ ファイルが 分割され たこと も 気にならないで 
しょう. （ヘッダ ファイルの 分割に ついては 「4.2.1 ヘッダ ファイルの 分割」 を 参照して 下 
さい,) 

( 2 ) 文字列 中に 漢字が 使われて いても 正しく 認識で きる ようになり ま した. Ver 丄 1 でも コメント 
に は 漢字が 書け ま し た 力;， 文字列 中に 使 うと 文字に よって は 文字が 変わ つてし まう ことがあ 
りました. しかし， コンパイル 時に スィ ツチ" -j" を 指定す る ことで 文字が 変わって しまう の を 
防ぐ ことができます. ただし， 漢字と 半角 ひらがなの 混在 はでき ません. 

(3) "-e，， と" -o" の 機能が 拡張， 変更され ました. まず 重要な ことと して， これらの スィッチの 後 
に は 他の スィ ッ チが 指定で きない 点です. Ver.1.1 では 次の よ うな ことができ ま した. 

A>cf - eaob file \<^\ 

これ は， エラー ファイル は ドライブ A に 作成 し， 中間 言語 ファイル は ドライブ B に 作成す る 
指定です. このままで Ver 丄 2 の CF を 実行す ると， エラー ファイル を カレント ディ レク ト リ 
に aob.dia という フ アイ ル 名で 作成す る だけ で， 中間 言語 フ アイ ルは ソースファイルと 同じ 
ディ レク ト リに できて しまいます. Ver 上 1 と 同じ 動作 をさせる に は 次のように します. 

A>cf -ea ~ob file(3 

これによ つて Ver 丄 1 と 同じ 動作 をし ます. つまり， スィ ツチ を それぞれの 機能 ごとに 分割す 
る 必要が あります. で すがこの 制限 は これらの スィ ツチの 後ろに 他の スィ ツチが 指定で きな 
いだけ で， 他の スィッチの 後ろに"- e" や" -o" が あるの は 構いません. 逆に この 制限 をつ ける 
こ と で 分か り やす さや， 拡張が されて いる ので 問題ない でし よ う • 

この 他に"- e" と" -o" は ドライブの 指定 だけでなく， バス 名， ファイル 名， 拡張 子の 指定 ま 
で 出来る ようにな りました. また， "-0'， では 直後に ファイル 名 を 指定し なくても エラー 表示 
されずに， その スィ ツチがなかった ものと して 解釈され るよう になって います. 
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B)CG 固有の 変 S 点 

(1) CF の" -o" ス イッチと 同じ こと が CG の"- o" ス イッチに も 適用され ています. つまり， ドライ 
ブ名， バス 名， ファイル 名， 拡張 子が 指定で きたり， この 後ろに は 他の スィッチが 指定で き 
ない などです. より 詳しく は CF の 項 を ご覧 下さい. 

(2) CG の 最中に エラーが 発生した ときには， 出力 ファイル である アセンブラ ファイル は 生成 さ 
れ ません. これ は， バッチ 中で CG を 使って いると きに アセンブラ ファイルの ある 無しに よつ 
て， 動作 を 決定す るのに は 便利です. 



OFPC 固有の 変 £jg 

(l)FPC によって チェック される ファイルが カレント ディ レク ト リに 存在し ない ときには， 起 
動され た fp に com が ある ディレクトリから 探して， 見つかれば それ を 使います. これ は 標準 
ライ ブラ リの FPC 用. tco ファイル など， よ く 使われる ファイル をい ちいち カレント ディ レ 
ク ト リ に コピー をしたり， バス 名 を 指定す る 必要 をな く すため です. fp に com と lib.tco は 対 
にして 同じ ディレクトリに fi いてお けば， lib.tco が カレント ディレクトリに なくても， FPC 
の 実行 は 次のように する ことで できます. 

A>fpc file lib 0 



D)MX 固有の 変更 点 

(1) MX は， MX 固有の ファイル を コマンド 内で 参照して います • それ は ard.bat， crel.bat とい 
う ファイルです. Ver 丄 1 では これらの ファイル は MX の 実行時に カレント ドライブに 無い 
場合に は 実行され ませんで した. しかし， Ver.1.2 では カレント ディレクトリに なくても， 起 
動され た mx.com が ある ディレクトリ を 探して 見つかれば それ を 使います. ard.bat, crel. 
bat の 内容 は ほとんど 変える ことがない ので， mx.com と 対に して 同じ ディ レク ト リに 置い 
てお くと いいでしょう. 変更が 必要な ときに は 変更され た arel.bat， crel.bat を カレント ディ 
レクト リ に 置いて おけば MX は それ を 先に 見つける ので， 変更され た 方 を 使う ことにな り ま 
す. 

(2) MX でも， '- 0 " スィ ツチの 機能が 拡張され ま した. MX の 動作の 主要な ものに フ アイ ルを 分割 
した も の を 作る 作業が あ ります. そ の 分割 された ファイル を どこ に 作成す る か を 指定す る の 
が，， -o" スィ ツチです. これ は ディ レク ト リ 名で 指定し ますが， 鑛 後が" ¥ ，'で 終って いなければ 
なり ません. これ は 複数の ファイル を 作成す るので ディ レク ト リ である 必要が あるからで 
す. "¥ "で 終って いない と き に は ス イッチ も 指定され ている とき に 意味 を 持って き ま 
す. "- 1" スィ ツチが あると MX は ライ ブラ リファイ ルの 作成の 手順まで 標準出力に 出力し ま 
す. "¥ "で 終って いない 時の ファイル 名 はこの 時の ライ ブラ リファイ ルの ファイル 名の 指定 
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に 使われます. ですから ライ ブラ リファイ ルは 分割され た ファイルと 同じ ディ レクト リ にし 

か 作成で きません. また， この 時 ライブラリ ファイル を 作成す る LIB80 も， MSX-D0S2 対 
応 版で なけれ ばな り ません. 

3.4.S 權準 ライブラリの 変 更 点 

(1) Ver.l.2 の 標準 ライ ゾラ リ をリ ンク した 実行 ファイル は MSX- D0S2 でなければ 動作し ま 
せ ん. MSX-D0S1 の 場合に は" This program needs MSX-DOS2" と 表示して 終了し ます. 

(2) ヘッダ ファイルが 分割され ました. し 力、 し， 今まで 通り プログラムの 先頭で stdio.h をィ ンク 
ルードす る だけで， すべての ライブラリ 関数 力 《使える ようになります. 

(3) へ ッダ ファイルの bdosfunc.h が Ver. 1 .2 になって ファンクション コ ール 名が 大幅に 変更 さ 
れ ました. これ は MSX- D0S2 リ ファレン ス マニュアルの ファンクション コール 名に 合わせ 
るの が H 的です. しかし， 今までに 開発した プログラムに 対応す るた めに， Ver. 1.1 のファ 
ン クシ ョ ン コール 名 を 使う こ とがで きる よう に 配慮され ています. それ は bdosfun に h を イン 
ク ルードす る 前に" HEADbdosfuncverll" という 定数 （マクロ） を 定義し ます • これで， その 
まま コンパイル 可能になります. 

#def i ne HEADbdosf uncver 1 1 
ft include <bdosfunc.h> 

(4) Ver.l.l の 標準 カーネル にあった， シーケンス 機能 （コマンドの 逐次 実行） はなくな り まし 
た. また， リダイレクト， パイプ 機能 は C0MMAND2 によって 処理され るよう になり まし 
た. argv [0] に は コマンド 名が 渡される ようにな りました. 

(5) 高水準 入出力の バッ フ ァ リ ング 方法が 3 種類に な り ま した. MSX-DOS2 の ファンクション 
コールに 依存して しまう 部分 も あり ます. 

(6) MSX-DOS2 の 機能で ある 階層 化 ディ レク ト リゃ 環境 変数， ファイル ハンドルの 操作の ため 
に 関数が 追加 • 変更され ています. 

(7) 漢字 対応の ための 関数 （マクロ） が 追加され ました. 追加され た 関数 は 2 つです が， 通常の 
プロ グラミ ング では 十分で しょ う. 

(8) 文字列 操作 関数で は 操作す る 文字 数の 上限 を 指定で きる 関数が 追加され ま した. 
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3.5 漢字 処理の 方法 

ここで は， MSX-C による 漢字 処理に ついて 解説し ます. MSX では 漢字 は 漢字 モードで ある 時 
に， キ 一ボードからの 入力， 画面に 表示， プリンタに 出力が できます. これらの 処理 はすべ て漢 
字 ドライバが 行って いるので， 漢字 ドライバが 起動され ていないと 動作し ません. 漢字の 入力に 
ついては， 漢字 ドライバ だけの 時 は 単 漢字変換 による 入力です が， フロントエンドプロセッサが 
ある 時には 文節 変換な どの 変換 方法に よって 入力す る ことができます. 入出力 を 伴わない 漢字 処 
理 について は 漢字 モ ードに 依存す る 割合 はずつ と 減ります. 

3.5, 1 MSX での 漢字の 内部 表现 

漢字 を 扱うた めに はまず， 漢字の 内部 表現 を 理解して いなければ なりません. そうでなければ 

ANK (1 バイトの アルファベット， 数字， カタ カナの こと） と 漢字の 区別が できません. 

MSX では 漢字の 内部 表現 は Microsoft Kanji Encoding Scheme に 従ってい ます. こ れは一 般 
にシフ ト JIS コードと 呼ばれて います. シフ 卜 JIS コード は 他の 漢字 コードと 同じ様に， 2 バイ ト 
で 構成され ます. しかし， JIS の 漢字 を 扱う ときに 必要な 漢字 シフ ト コードな どがない ので， ANK 
との 相性 （区別が 簡単） や データ 格納 効率が よくな つてい ます. また， JIS コードとの 変換 も 単純 
に 行え ま す. JIS コードと の 関係 は 下図の ようになって います. 

第 2 ノ、' ィ ト 目 

アスキーつ ード 00„ 20„ 40,i 60 H 80,i AOh C0« EOu FF H 



シフ ト J ほ 第 1 水準 ェ リア 


j - 

8,60 1( シフト JIS 第 1 水準 エリア 




" り - 洙: f シ フ ? "は 第. 2 水準： t リず》 9^0» 



以降 第 2 水準 
-94X 2 バイ ト 



IS バ, ィ ト 
…丄 …-- ^ 



： 米 

>s CO 

きラ 


H 
？被 

も 


将来の 拡張 用 


将来の 拡張 用 



* 漢字 スペース コー ド 
図 JIS コードと シフト JIS コードの 関係 



i 

コン トロール 

文字 



記号 Z 数字/ 

英 大文字 



英小文字 Z 

記号 



未定義 I 



号 Z 

カタ カナ 



未定義 I 



00„ 



20„ 



40" 



第 60„ 



80 K 

卜 

目 A0 H 
C0„ 
E0„ 
FF» 



34 バイ ト ^ 

」15第1 水準 エリア 



7:1 



ま ml?- 1. m .^Ai^/S 
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シフト JIS コード は JIS で 決め ら れた 1 バイト 文字の 未定義 部分 を 漢字 コードの 第 1 バイト 
に 割り当てて いるので， 1 バイ ト目を 調べる ことで それが ANK か， 漢字の 第 1 バイ ト かが 分かり 
ます. 



内部 表現で ある シフ 卜 JIS コード は， MSX-DOS だけでなく MSX-BASIC でも 使用され てい 
ます. また， 16 ビット コンピュータの 標準 DOS である MS - DOS とも 同じ ものです. ですから 
MS-DOS で 作成した 漠 字の ファ ィ ルを， MSX- BASIC で 表示す る こ と も 可能です. 



MSX を 含めて コンビ ュ一タ で データの 交換に 使われる コード は， や はり JIS コードで ある 場 
合が 多いた め， ここで は 参考 资料 として MSX-C で 記述され た， シフト JIS コードと JIS コード 
の 変換 関数 を 挙げてお きます. sjis2jis () はシフ ト JIS コードから J1S コードへの 変換 を， jis2sjis 
() は JIS コー ド から シフ 卜 JIS コード への 変換 を 行い ます. それぞれ 引数に は unsigned 型で シ 
フト JIS コード， JIS コード を 渡します. 



^include <stdio,h> 
/* 

convert a shift - J IS kanji character to JIS 
シフト JIS コード 一 > JIS コード 

*/ 

unsigned sjis2jis(sjis) 

unsigned sj is; 

{ 

TINY し h; 

h = (sjis » 8) 一 0x71； 
if (h > 0x2e) 

h - = 0x40； 
h = h * 2 + 1； 
1 = (sjis & Oxff) - Oxlf; 
if (I > 0x60) 

卜 -； 

if (1 >= 0x7f) { 
h++; 

I 一 = 0x5e; 

} 

return ((unsigned)h * 256 + 1); 

} 

/* 

convert a JIS kan j i character to shift - J は 
J 1 S コード 一 > シフト J 1 S コード 

*/ 

unsigned jis2sjis(jis) 

unsigned jis; 

{ 

TINY 1. h; 
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h = (jis » 8) - 0x21; 

1 = (TINY)Qis & Oxff) + ((h t 1) == 0 ？ (TINY)Oxlf ： (TINY)0x7d); 
if (I > 0x7e) 

1++； 
h = h / 2； 
if (h > Oxle) 

h += (TINY)0x40; 
h += 0x81； 

return ((unsigned)h * 256 + 1)； 

} 



3,5,g 漢字 の 区別 

MSX では 本当に 漢字 かどう か は， 1 バイ ト 調べた だけで は 判りません. それ は， 漢字の 第 1 バ 
イト 目と 1 バイ トの ひらがなの 範囲が 同じ だからです. この 区別 は 作成す る コマンドで 漠字を 使 
う 力 \ ひらがな を 使う かによ つて 行います. 次のように 分ける のがい いでしょう. 

(1) 漢字 を 使う （1 バイト ひらがな を 使わない） 時と は， 

コマンドの スィ ツチで 漢字 を 使う 宣言が されて いる 時 
または 

コマンドの スィ ツチで ひらがな を 使う 宣言が されて いない 時 

または 
漠字 モードの とき 

(2) 1 バイト ひらがな を 使う （漠字 を 使わない） 時と は， 

コマンドの スィ ツチで 漢字 を 使う 宣言が されて いない 時 
または 

コマンドの スィ ツチで ひらがな を 使う 宣言が されて いる 時 

または 
漢字 モードで ない 時 

(1)， （2) の 1 番目の 条件 は 漢字が あまり 使われない コマンドの 時に 使用し （漢字の 時には 漢字の 
指定が 必要〉， 2 番目の 条件 は 漢字が 主に 使われる コマンドで 使います. これらの 分け 方 は 画面の 
漢字 モードに よらず， 指定で きる 点が 利点です. ただし， コマンド によって 漢字の 扱いの デフ ォ 
ルトを 変える と， 漢字の ための スィッチ をつ ける のか， いらない のかな どの 混乱が 生じる ので 統 
—した 方が いいでしょう. 漢字 を 使う スィ ツチと ひらがな を 使う スィ ツチ 両方 を コマンドが 受け 
付ける ようにす るの も ひと つの 解決 方法です. MSX-C の CF コマンド は， デフォルト は ひ ら がな 
を 使う モードで， 漢字 を 使う 場合に は" -j" スィ ツチが 必要で あるよう に 設定され ています. 

3 番目の 条件 は， コマンドが すべて 自動的に 判定して くれる 方法です. この場合， 現在の 漠字モ 
ード がどうな つてい るか をコ マン ド が 知っている 必要が あ ります. です が， MSX-DOS2 の ファン 
クシ ヨン コール を 上手に 使う ことで， 直接 漠字 モード を 知らなくても 処理 は 可能です （¥CIIK- 
CHJR(5DH) など を 使う）. 
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これ 以外に も 現在の 漢字 モード を デフォルト にして， 漢字 用， ひらがな 用の それぞれの ス イツ 
チを 作ったり， 環境 変数 を 見て 決めるな どで もい いでしょう. 



3,5,3 漢字の 処理 

ここで は， 処理す る もの は 漢字 は 含められ ますが， 1 パイ 卜の ひらがな を 含まない ものと して 説 
明し ます. 



シフ ト JIS コードの 場合， 文字列の 先頭から 1 バイ ト ずつ 調べなければ， ある 1 バイ トの 文字 

がどうい う 文字 （漢字の 1 バイト 目と 力、， ANK であると か） だか 判りません. 処理と して 基本的 
に は 次の よ う にします. 文字列の 先頭から 1 バイ 卜 iskanji () で 調べ， FALSE だったら ANK の 
処理 をし ます. TRUE だったら その 文字 は 漢字の 第 1 バイトな ので， もう 1 ノ 《イト （2 ノ 《イト 目） 
を 取って きて， 2 バイ トの 組で 漢字に 必要な 処理 をし ます. この 操作 を 繰り返す ことで， 漢字 対応 
の 文字列 操作が できます. 



例 



# in kinclude <stdio.h> 

h /* 文字列 s 中の ANK の 小文字 を 大文字に する （漠宇 対応版） 
cha chap 
cha char お； 

{ { 



char 
ch&r 



本 head 二 sj 
c; 



while (c = *s) { 

if (iskanji (c)) /* 1 バイト 調ぺる */ 

/* 漢字な ので そのまま 1 バイト 進める */ 



else 



s++; 



} 

return (head); 



s++; 



*s = toupper(c);A ANK は 必要なら 大文字 変換 */ 
/* 次の 文字 を 指す ようにす る */ 



次に ある， chkctype()， nthctype ( ) は， ある 1 バイトが ANK か 漢字 か を 調べる 関数です. 
chkctype () では ひとつ 前に 調べた 文字の タイプ を 渡して， 現在の 文字が 何 か を 調べます. これ 
は， プログラムで 1 文字ず つ 文字の タイプ を 把握す る 必要が ある 時に 使います. nthctype() は， 
文字列の 途中の 文字の タ ィ プを知 りたい とき に 使い ま す. 
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itinclu 


de <stdio.h> 








#defin 


e CTJNK (TINY)O 


/* 


ANK */ 




ttdefin 


e CTJJi (TINY)l 


/* 


漢字の 第 1 バイ ト */ 




ttdefin 


e CTJJ2 (TINY)2 


/* 


漠 字の 第 2 バイ ト */ 




*define CTJLGL (T 盼 1 




不正な 文 宇， 値 */ 




TINY 


chkctype(c, type) 


/* 


文字の 種類 を 1 文字 綢ぺる 


*/ 


char 


0； 


/* 


調べたい 文字 を 渡す 


*/ 


TINY 


type; 


/* 


ひとつ 前の 文字の タイプ を 渡す 


*/ 



{ 

switch Ctype; { 
case CT.KJi: 

if (iskanj 12(c)) 



type = CT.KJ2; 

e 1 

type = CTJLGL; /* 渙 字の 第 2 バイ トが 不正 */ 

bre$ レ 

/* ANK, 漢字 第 2 バイ トの次 は ANK, 漢字 第 1 バイ トが 来る */ 

case CT.ANK: /* ANK */ 

case CTLKJ2: /* 漢字の 第 2 バイ ト 

case CTJLGL: A 不正な 漢字 第 2 バイ ト */ 

default: 

if (iskanj i(c)) 

type = CT.KJI ； /* 漢字 第 1 バイトだった */ 

type = CTJNK; 1% ANK だった */ 

break; 

} 

return (type); 

} 

/* 文字列 s の n バイト 目が どういう 文字 か を 調べる */ 
TINY nthctype(s, n) 
char *s; 

int n; specify n >= 0 */ 

TINY type = CTJLGL; 

/* 文字列の 先頭の 前 は CTJLGL とする */ 
A n < 0 の 時に も CTJLGL を 返す */ 
/* 途中で CTJLGL や' ¥0' になっても 無視され る */ 
while (n— >= 0) 

type = chkctype(*s++, type ゾ i 
return (type); 

} 
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こ の 章で は MSX-C コ ンパ イラに 付厲 する 標準 ライ ブラ リ の 特徴に ついて 細か く 述べられて 
います. 個々 の 関数の 詳細に ついては 「第 6 章 標準 ライブラリ 関数 リファレンス」 を 参照して 
下さい. 



4.1 MSX-C の欐準 的な 型 

現在の MSX-C で サポートされ ている 基本 型 は 整数 型 と 文字 型 と そ の 組合せ の 構造体 • 共用 体 
です が， 基準と なる ANSI では void などの 有用な 基本 型が 採用され ています. MSX-C の 標準 ラ 
ィ ブラ リ でも 基本 型の 種類 は 変わらな いものの， その 有用性 や プログラムの 分かりやす さな どか 
ら， あらかじめ 標準 的な 型 を 定義して います. 

BOOL, FD, STATUS, size— 1， TINY, VOID の 各 型が ヘッダ ファイル type.h で 定義され て 
います， type.h は 他の すべての ヘッダ ファイルで 自動的に 読み込まれ ますので， ユーザー は その 
存在 を ほ とん ど 意識す る 必要 は あ りません， また stdio.h では FILE が、 bdosfunc.h では FCB, 
FIB, LONG, XREG が 定義され ています. 各々 の 型で 使用され る 値に ついては 「4. 2. 3 ヘッダ 
ファイルの 内容」 を 参照して 下さい. 

4 丄 1 BOOL 型 

この 型 は 2 値 論理 （TRUE と FALSE, YES と NO など 2 つの 値し か 持たない） 用の データ 型 
です， 例えば， isdigit () 関数 は パラメータの 文字が 数字 か （TRUE), 数字で ないか （FALSE) 
のど ちらか を 必ず 返します （B00L 型の 関数). この 関数 値 を 保持したい 場合に は B00L 型で 宣 
言され た 変数 を 使用す るの がいいでしょう. また B00L 型 は， if 文な どの 条件 式に そのまま 変数 
や 関数 を 書く ことで， 直感的で 分かりやすい プログラムの 記述が できます. 

B00L 型 はへ ッ ダフ アイ ル type.h で 定義 されて います， 



例 | 

STATUS SaneCase(s) /* 最初の alphabet の ケースに そろえる */ 

char *s; 

{ 

BOOL upper; 

while (*s && ！ isalpha(*s)) 1% 最初の alphabet の サーチ 本/ 

if (！ *s), 

return (ERROR); 
upper = isupper(*s); 
while (*s) { 

if (upper) ゾ * 



/* alphabet はなかった %l 
最初の alphabet は 大文字だった %l 
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putchar(toupper(*s)); /* 大文字に して 出力 */ 
putchar(tolower(*s)); 1% 小文字に して 出力 */ 

} 

return (OK); /* 目的 通りの 事が できた */ 

} 



4,1,2 FCB 型 

MSX-DOS1 の ファイル アクセス ファンクション コー ルを 使用す る の に 必要な FCB を， 構造体 
として 定義した ものです. MSX-DOS2 では アセンブラ 言語で も ファイル ハンドル によって ァク 
セ ス が 可能に な つたた め に ほ と ん ど 必要 ありま せんが， 旧 バージョンの MSX-C と の 互換性の た 
めに 用意され ています. 定義され ている FCB 型 は MSX-DOS1 用 の FCB です の で， MSX-D0S2 
と は 完全な 互換性はありません. 詳しい 内容 は 「MSX2 テクニカル ハンドブック」， MSX-DOS 
TOOLS の 付属の マニュアル や MSX-DOS2 の リファ レンス マニュアル 141 ページ を 参照して 下 
さい. 

FCB 型 は ヘッダ ファイル bdosfunc.h で 定義 されて います， 



4,1,3 FD 型 

この 型 は 低水準の 入出力 関数 （open () や read () など） に 使用され る ファイル ハンドル を 表す 
型です. 標準 C などで は ファイル ハンドル は 負で ない 整数が 使われる ので， int 型で 宣言し ます 
が， ファイル ハンド ル 用の 変数で あ る こと を 強調す るた めに FD 型が 用意され て います. 

FD 型 は ヘッダ フ アイ ル type.h で 定義 されて います. 



例 | 

FD fd; 

char bufCBUFSIZ]; 

if ((fd = open('，file"， 0— RDONLY)) == ERROR) { 
puts("File not foundVn"); 
exit(l); 

} 

if(read(fd, buf, BUFSIZ) == 0) { 

puts("File has no dataVn M )l 
exit(l); 

} 
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4.1.4 F 旧型 



FIB 型 は MSX-D0S2 に 固有の もので， ファイルの サーチな ど をす る 時に 使用され る 領域 
(F1B) を 構造体 とした ものです. 詳しい 内容 は MSX-D0S2 の リファレンス マニュアル 136 ぺー 
ジを 参照して 下さい. 
FIB 型 は ヘッダ ファイル bdosfunc.h で 定義され てい ま す. 

4,1,5 FILE 型 

こ の 型 は 高水準の 入出力 関数 （fopen ( ) や getc ( ) な ど） がバ ッ フ ァ の 制御に 使用す る 構造体で 
す. ユーザ一 が この 型 を 使用して 宣言す るの は ほとんどの 場合が （FILE 型への） ボイ ンタの 定義 
です. また， 高水準 入出力 関数 を 使って 入出力す る ときには， ファイルの 指定 は fopen 0 から 返 
された FILE 型への ボイ ンタ によって 行われます. FILE 型の 変数 を 定義しても それ を 使って フ 
アイ ルの 入出力 をす る こと はでき ません， 

FILE 型 は ヘッダ フ アイ ル stdio.h で 定義 されて います. 



例 1 

^include <stdio.h> 
int c; 
FILE *fp; 

if ((fp = fopen("test.dat", "r")) == NULL) { 
putsC'Ftle not found¥n"); 
exit(l); 

} 

while ((c = getc(fp)) != EOF) { 
} 



4.1.6 LONG 型 

この 型 は FCB 型の なかで 4 バイ 卜の 領域 を 確保す るた めに 定義され ています. 実際に は 使用 
する こと はでき ません. 
LONG 型 は ヘッダ ファイル bdosfun に h で 定義 されて います. 

4.1 .7 size_t 型 

こ の 型 は 領域 や 文字列の 大 き さ を 表す 時に 使われます. 標準 ラ ィ ブラ リ で は strlen ( ) の 戻り 値 
などで 使用され ています. 
size t 型 は ヘッダ ファイル type.h で 定義 されて います. 
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4,1-8 STATUS 型 

この 型 は BOOL 型に 似た ところ もあります が， 関数の 実行 結果の 状態 を 返す ものです. STA- 
TUS 型 はお もに ERROR (処理 失敗） と OK (処理 成功） の 2 つの 値 を 保持し ます. 
STATUS 型 は ヘッダ ファイル typeh で 定義 されて います. 

EE 

^include <stdio.h> 
^include <lo.h> 

if (unlink( M editor.bak w ) == ERROR) 

puts( M Back up file not exist¥n")l 



4,1,9 TINY 型 

8 ビット の 数値 型で， 値と して 10 進数で 0 か ら 255 ま でが 使用で き ます， こ の 型の 利点 は int 型 
にくらべて 占める 空間が 小さい ことと 演算が 速い ことです. 欠点と して は 表現で きる 数値の 範囲 
が 狭い ことです. しかしながら， 小さな 配列の 添字 や 数回の ループ 変数な どで は 十分です. 

TINY 型 は ヘッダ ファイル type.h で 定義 されて います. 



例 1 

Itinclude <stdio.h> 
TINY countCIO]; 
TINY i; 
int c; 

for (i = 0； i < 10； 
countCi] = 0; 

while ((c = getcharO) != EOF) 

if (isdigit((char)c» 

countCc - '0*]++； 
for (i = 0； i < 10; i++) 

|intf( w Xd: JW¥n"， (int)i, (int)countCi]); 



4,1 .10 VOID 型 

この 型 は データ 型で はな く コ ン パイ ラ （MSX-C の 場合 は プログラマ） への 宣言と 言えます. 関 
数の 定義， 宣言の 際に 使用し， 関数の 戻り 値がない こと を 意味し ます. VOID 型の 値 を 受け取った 
り， 返したり はでき ません. 

VOID 型 は ヘッダ ファイル type.h で 定義 されて います. 
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^include <stdio.h> 

VOID noretO 
{ 

putsCThis function returns no value. ¥n M ); 

} 



4,1,11 XREG 型 

ある アドレスに レジスタ を 設定して コールす るた めの 関数 callxx () があります. その パラメ 
ータ として， レジスタの 値 を 指定す るた めの 領域が 必要です が， それが XREG 型です. この 構造 
体に 値 を 設定して その ボイ ンタを callxx ( ) に 渡す こと にな り ます. 

XREG 型 はへ ッ ダフ アイ ル bdosfunc.h で 定義 されて います. 



例 I 

^include <stdio.h> 
# include <bdosfunc.h> 
XREG reg; 

res. be = (unsigned).GETDTA; 
callxx(BDOS, &reg); 

printf ("Current DTA is X04x¥n", reg.de)； 



4,g へッカ アイ ル 

c 言語で は 通常 プログラム を 作成す る 場合， 標準 ラ ィ ブラ リ を 使用 します. こ の 標準 ラ ィ ブラ リ 

関数 を 使用す るに は， プログラム 中で その 使用 宣言 をし なければ なりません. しかし ユーザーが 
使用 宣言 を 関数 ごとに していた ので は， 手 問が かかって しまいます. その 手間 を 省き， 一括して 
使用 宣言す る ものが ヘッダ ファイルです. ユーザー は 使用す る 関数が 含まれて いるへ ッ ダフ アイ 

ルを include 命令で 読み込む ことで， 関数 ひとつひとつの 宣言 や， 定数の 定義 をし なくて すみ ま 
す， 

4,2,1 ヘッダ ファイルの 分割 

MSX-C Ver. 1.2 では ヘッダ ファイル は 関数の 種類に よって 分類， 分割され ています. 種類と 
して は 高水準お よび 低水準 入出力 関数， 文字列 操作 関数， メモリ 管理 関数な ど 様々 です. Ve に 1. 
1 までの ヘッダ ファイルの 構成 は stdio.h と bdosfunc.h の 2 つで， 前者 は ほとんどの 関数 を， 後者 
は MSX- DOS の ファンクション コール を 使用す る 場合に 必要な 関数 や 定数の 定義 をして いる も 
のでした. 
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Ver.1.2 で 分割され たの は， 標準 ライ ブラ リ の 関数が 増えた ことによ る 必要ない 関数の 宣言で， 
ユーザーの シンボル テーブル を 圧迫し ないた めと， コンパイル 時間の 短縮の ためです. しかし， 
Ver.1.1 までの コー ディ ング スタイル である， 「プログラムの 先頭で stdio.h のみ をィ ン クルー ド 
する.」 ことに 支障 をき たさない ための 配慮が されて います. つまり， 単純に stdicxh を イン クル 
ードし た 場合に はすべ ての ヘッダ ファイル を イン クル一 ド します （stdio.h が さらに インクルード 
する）. 分割され た ファイル を 個々 に インクルード するとき は" #define DIVHEADER" という 
行 を C の ソースファイルの 先頭に 入れて おきます. これによ つて stdio.h は 不必要な 自分自身 以 
外の ヘッダ ファイル を インクルードし なくなります. また， bdosfunc.h は 別個に インクルードし 
なければ なりません. 

(1) Ver.1.1 までの 方法 
^include <stdio.h> 

nainO 

C 

} … 

(2) Ver.1.2 の 方法で stdio.h だけ をィ ン クルー ド 

#define DIVHEADER 
tlinclude <stdio.h> 

mainO 
{ 

} 

(3) Ver.1.2 の 方法で stdio.h と stdlib.h を インクルード 

Sdeflne DIVHEADER 
^include <stdio.h> 
ttinciude <stdlib.h> 

nain() 
{ 

} … 
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(4) Ver.1.2 の 方法で direct.h と stdlib.h を インクルード 
/* 

♦define DIVHEADER の 行 は 

stdio.h を インクルード しないた め 必要ない 

*/ 

^include <direct.h> 
# include <stdlib.h> 

nainO 

{ 

} * 

4.S.S へ, ジカ アイ ルの インクルードの 方法 

ヘッダ ファイル は 通常 まとめて， ひとつの ディレクトリに 置いて おきます. （a ： ¥include など 
に 置く.） Ver.1.2 の CF では ィ ンク ルード （# include) する ファイルの デフォルトの ディ レク ト 
リを 指定で きる ので， それ を ヘッダ ファイルの まとめて ある ディレクトリに 設定し ます. デフ ォ 
ルトの ディ レク トリの 指定に は 環境 変数 include を 使用し ます. この 環境 変数に は ひとつの ディ 
レク ト リを 設定で きます. 

ィ ンク ルードの デフォルト ディ レクト リを a ： ¥include に 設定す る. 
A>set i nc 1 ude=a :¥include@ 

a ： ¥include にへ ッ ダフ アイ ルを 入れて おけば ほかの ディ レクト リ にへ ッ ダフ ァ ィ ル がな く て 
も CF はき ちんと コンパイル します. 



#include に は 2 通りの 書き方が あります. まず， よく 使われる もの は インクルード する フ アイ 
ル を，， く" と，， > "で 囲む ものです. この 使い方で はィ ンク ルードの デフォルト ディ レク ト リ をサ一 
チし， あれば その ファイル を インクルード します. 見つからなければ， その 旨 を 表示して コンパ 
ィルを 中止し ます. もう 一方の 使い方 は ファイル 名 を，， で 囲みます. この 指定 だと， カレント デ 
ィ レクト リ をまず サーチし， あれば それ を インクルードし， なければ デフォルトの ディレクトリ 
を サーチし ます. それでもなければ コンパイルが 中止され ます. 注意す る ことと して， ファイル 
名に ドライブ や ルー 卜 ディ レク ト リ からの 指定が ある と， デフォルト ディ レク ト リ を サーチし な 
いこと です. また， #include での ファイルの 指定 中の ディレクトリの 区切り は" ¥ '，は ひとつし か 
必要 あり ません （# include "¥myhead¥mylib.h" と 指定 すれば いい）. 

一般的な # include の 使い方と して は， 標準 ライブラリ の 宣言 として 使う ものに は" く" と"〉" で 
囲み， ユーザ一 独自の ヘッダ ファイルの 場合 は" を 使って 囲みます. 
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(1) # include <stdio.h> 

デフォルト ディレクトリ を サーチし， あれば インクルード します. なければ エラ一 表示 
して コンパイルが 中止され ます. 

(2) 开 include "myhead.h" 

カレント ディレクトリ， デフォルト ディレクトリの 順に サーチし ますが， 見つかつ たと 
ころで その ファイル を インクルード します. どちらに もなければ， エラ一 表示して コン 
パイルが 中止され ます. 



4,2,3 ヘッダ ファイルの 内容 

ここで は， 13 個 ある ヘッダ ファイルに 何の 宣言が あるか を 個々 に 見て いきます. 関数の 詳細 は 
「第 6 章 標準 ライブラリ 関数 リファレンス」 を， 型の 説明 は 「4.1 MSX-C の 標準 的な 型」 を 
参照して 下さい. 定数が 定義され ている ヘッダで は その 説明 を 行います. 定数 は プログラムで 自 
由に 使う こと はでき ますが， 変更す る こと はでき ません. 



A) bdosfunch 

bdosfunc.h に は MSX- D0S2 の ファンクション コール を 直接 実行す る ファンクション コール 
名 を 定義して あります. つまり， 標準 ライブラリ 関数で 足りない もの を， 直接 MSX-DOS のファ 
ン クシ ヨン コール をす る ことで， 補う ときに 使う も のが 入って い ま す， 

型 FCB 型， FIB 型， XREG 型 

関数 bdos ( )， bdosh ( ), bios ( )， biosh (), call ( )， calla ( )， callxx ( ) 

定数 "一" で 始まる もの これら は MSX- DOS の ファンクション コール 名 を その 番号 

と 対応 させた ものです. 

"BIOS" で 始まる もの bios () で 使える ファンクション 番号です， 
BDOS MSX-DOS の ファンクション コール を 呼び出す 番 

地 を 設定して あります. 




bdosfunc.h は Ver . 1 . 2 になって ファンクション コール 名が 大幅に 変更 されました. これ は 
MSX-D0S2 リファレンス マニュアルの ファンクション コール 名に 合わせる のが 目的です. しか 
し， 今までに 開発した プログラムに 対応す るた めに， Ver. 1.1 の ファンクション コール 名 を 使う 
ことができ るよう に 配慮され ています. それ は bdosfunc.h をィ ン クルー ド する 前に "IIEADbdos- 
funcverll" という 定数 （マクロ） を 定義し ます. これで， そのまま コンパイル 可能になります. 
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#def ine HEADbdosfuncverll 
^include <bdosfunc.h> 

B)conio.h 

conio.h に は キー ボー ド からの 直接 入力 関数と I/O ポー ト に 関連す る 関数の 宣言が 含まれて い 
ます. 

関数 getch 0, getche 0, kbhit ( ), sensebrk ( ) 

inp ( ) ， outp ( ) 



Octypah 

ctype.h は， 文字が どんな 文字 種 か を 調べる ための マクロが 含まれて います. また， 文字 を大文 
字 や 小文字に 変換す る 関数の 宣言が 含まれます. isalphaO, isupper (), islowerO, isdigit 
()， isspace 0, iscntl (), iskanji 0, iskanji2 ( ) は， 関数で はなく パラメータ 付 マクロと して 
実現され ています. これら は パラメータ を 2 度 以上 評価す る ことがあ るので， 副作用の ある 式 を 
パラメータ として 渡す と 正しく 動作し ません. ですから これらの 5 つの 関数に， 副作用の ある 式 
を 渡して はいけ ません (副作用の ある 式と は， + + や一 演算子， 代入 演算子， 関数 呼び出し を 含む 
式の こと）. 

マクロ isalnum ( )， isalpha ( )， iscntrl ( )， isdigit ( )， islower ( ) 

iskanji ( ), iskanji2 ( )， isspace ( ), isupper ( )， isxdigit ( ) 
関数 tolower ( ) ， toupper ( ) 

D) directh 

direct.h は ディ レク ト リ 関係の 関数の 宣言が 含まれて います. 
関数 chdir ( ) ， expargs ( ) ， getcwd ( ) ， mkdir ( ) , rmdir ( ) 

E) io.h 

io.h は 低水準 入出力 関数な ど ファイル ハンドル を 使用して アクセス する 関数の 宣言が 含まれて 
います. 

関数 close 、 ) ， creat ( ) ， eof u , isatty ( ) ， open ( ) 

read ( ) ， rename v ) ， unlink ( ) ， write ( ) 
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0 一 RDONLY 


open () の 読み込み モ、 


ード のた めの 定数 


0 一 WRONLY 


open () の 書き込み モ、 


ード のた めの 定数 


0 一 RDWR 


open () の 読み書き 両用 モードの ための 定数 


STDIN 


ファイル ハンドル 0 を 示します. 


STDOUT 


}) 




〃 


STDERR 


)) 


2 


〃 


STDAUX 


〃 


3 


)) 


STDPRN 




4 


〃 


STDLST 


〃 


4 


n (STDPRN と 同じ) 



F)malloc.h 

malloch に は メモ リ 管理 関数の 宣言が 含 まれて います. 
関数 alloc ( )， free ( )， sbrk (), rsvstk ( ) 



G)memory.h 

memory .h に は メモリ を 直接 操作す る 関数の 宣言が 含まれて います. 
関数 memcpy ( ) ， memset ( ) , movmem ( ) ， setmem ( ) 



H)process.h 

process.h に は， プログラムの 終了 や 起動な ど， コマンド そのものに 関わる 関数の 宣言が 含まれ 
ています. 

関数 execl ( ) ， execv 、 ) ， exit \ ) , exit ( ) 



DsetJmp.h 

setjmp.h に は 関数 間 を 越えて の 分岐の ための 関数の 宣言 と 型の 定義が 含 まれて います. 

型 jmp_buf 型 

関数 longjmp ( ) ， setjmp ( ) 
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J)stdio.h 

stdio.h に は 高水準 入出力 関数の 宣言， FILE 構造体の 定義， マクロ， 定数の 定義が 含まれて い 
ます. また， MSX-C Ver.1.1 までの stdio.h と 互換性 を 保った めの 他の ヘッダ ファイルの イン 
ク ルード も 含まれて います. 



型 

マクロ 
関数 



定数 



FILE 型 

fileno ( )， feof ( )， ferror ( ) 

clearerr ( )， fclose ( )， fcloseall ( )， fflush ( ), fgets ( ) 
flushall ( )， fopen (), fprintf ( )， fputs ( ), fread ( )， fscanf ( ) 
fsetbin (), fsettext ( )， f write ( )， getc ( )， getchar ( )， gets ( ) 
printf ( ) ， putc ( ) ， putchar i ) ， puts ( ) ， scanf ( ) 
setbuf ( ) ， setvbuf ( ) ， ungetc ( ) ， ungetch ( ) 



BUFSIZ 



EOF 



匪し ES 



JONBF 

JOLBF 

一 IOFBF 

stdin 

stdout 

stderr 

stdaux 

stdprn 



高水準 入出力 関数の バ ッファ の 大きさ は BUFSIZ になり ま 
す . setbuf () で 与える バッファ はこの 大きさで なければ いけ 
ません. 

ファイルから の 入力が ェ ン ドォブ ファイル ま で 行われた こ と 
を 示す 値です. 

高水準 入出力 関数で 同時に オープン する こ とがで きる フ アイ 
ルの 最大 数が 定義され ています. これに は stdin, stdout, 
stderr, stdaux, stdprn が 含 ま れて います. 
setvbuf () で バッファリング なし を 指定す る 値です， 
setvbuf ( ) で 行バッ ファリ ングを 指定す る 値です. 
setvbuf () で フル バッファ リ ングを 指定す る 値です. 
標準入力 を 表す フ アイ ル FILE 型への ボイ ンタ です. 
標準出力 〃 
標準 エラー 出力 " 

標準 補助 出力 〃 
標準 プリ ン ター 出力 )) 



K)stdlib.h 

stdlib.h に はよ く 使われる 関数です が 他の ヘッダに 分類で きない ものが， 集められ ています. 

関数 abs u , atoi i ；, getenv 、 ハ max ( )， min ( ) 

putenv ( )， qsort ( ) 
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L)string.h 

string.h に は 文字 や 文字列の 操作 をす る 関数の 宣言 を 含んで います. 

関数 sprintf ( )， sscanf ( )， strcat ( )， strchr ( ) 

strcmp ( )， strcpy ( )， strlen ( )， strlwr ( ) 
strncat ( ), strncmp ( )， strncpy ( )， strupr ( ) 

M)type,h 

type.h に は， MSX-C で 使われる 標準 的な 型 を 定義して います. また， その 型に 使われる 値の 定 
数 も 定義して います. 

型 BOOL 型 

定数 NULL 



TRUE 

FALSE 

YES 

NO 

OK 

ERROR 



FD 型， size 一 t 型， STATUS 型， TINY 型， VOID 型 
どこも 指して いない ポインタ として 使います. ま 
た， ポインタ を 返す 関数で は エラーと して 使われ 
ます. 

BOOL 型 用で， 真 を 表します. FALSE と 対になります. 
BOOL 型 用で， 偽 を 表します. TRUE と 対になります. 
BOOL 型 用で， 真 を 表します. NO と 対になります. 
BOOL 型 用で， 偽 を 表します. YES と 対になります. 
STATUS 型 用で， 処理の 正常終了 を 表します. 
STATUS 型 用で， 処理の 異常終了 を 表します. 
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4.3 權準 ライブラリ H 数 概要 

MSX-C Ver.l，2 に 付属す る 標準 ライブラリ は MSX-D0S2 上での み 動作し ます. 標準 ライ 
ブラ リを リンク して 作成され た コマンド は， 実行 前に MSX-DOS の パージ ヨン を チヱ ック し， バ 
一 ジョン 2 以上で ない と" This program needs MSX-D0S2" と 表示して， 実行され ません. 

4,3,1 ファイル 入出力 閱数 

C 言語で は ファイルの 入出力 は 3 段階 （オープン， 入出力， クローズ） に 分けられます. 

(1) 最初に ファイル を オープン します. この 操作で ユーザー は オープンの 関数 (fopen () や open 
()) に ファイル 名と 読み出し か ® き 込み かの モード を 与えます. すると 関数 は， 以後 フ アイ 
ル アクセスに 必要な 情報 を 返します. （fopen () では FILE 型への ボイ ンタ， open () では FD 
型の 値） ユーザー はこの 値 を 変数に 保存して おきます. 

(2) 次の 段階 は データの 入出力です. ここで は 実際に ファイルから データ を 読み出す 力、， 書き込 
むか をし ます. しかし これ は， ファイルの オープン 時の モードの 指定と 同じで なければ いけ 
ません. データの 読み出し では ユーザー は 関数に， 保存して ある ファイル を 指定す る 値， 読 
み 出した データ を 格納す る 位置， 読み出す 量 を 渡します. （fgets() や read ()) 書き込みで 
は ファイル 指定の 値， 書き込む データが ある 位 H， 書き出す 量 を 渡します. （fputs () や write 
()) 関数に よって は 読み込んだ データ を 返す もの （getc())， 書き込む データ を 渡す 関数 

(putc()) も あり， いつも 3 つの 情報 を 渡す わけではありません. しかし それ は， 隠されて 
いる だけ （暗黙 的に 指定して いる） と言えるでしょう. 

(3) 最後の 段階 は ファイルの クローズです. クローズの 関数 （fclose() や close ()) にはフ アイ 
ル 指定の 値 を 渡す だけです， 読み出しで オープン された ファイル に対して はた だ 単純に 使用 
していた フ アイ ル 管理情報 を 捨て る だけです が， 書き込み モードで はもう ひとつ 行う こと が 
あります. それ は， ディスクに 書き出し ていない データ を ディスクに 書き出す ことです. 書 
き 出した 後 は 読み出し モードと 同じ 処理になります. 

以上で フ ァ ィ ルの 入出力が 一通 り 終りました. フ アイ ルは 必要で あれば 複数の ファ ィ ルを 同時 
に 入出力で きます. また プログラムが 起動され たと き， よく 使われる ファイル に関して はすで に 
オープンされ ている ので， すぐに データの 入出力が できます. 

ファイル 入出力 関数 は， 大きく 2 つの グループに 分類で きます. ひとつ は 高水準 入出力 関数 
(fopen (), getc() など）， もう ひとつ は 低水準 入出力 関数 (open ( )， read () など） です. MSX 
-C Ver. 1.2 の 標準 ライブラリ では， UNIX や MS- DOS の 環境と 同様な リダイレクションと パ 
ィ プラインが サポートされ ています. 標準入力 と 標準出力 は コマンド ラインから ファイルに 変更 
できます が， 標準 エラ一 出力 は， コンソールに 固定され ており， 変更す る こと はでき ません. 

入出力 関数で は， ディスク ファイルの 他に， MSX-DOS の デバイス ファイル も 扱えます. それ 
ぞれの デバイスに 許される 操作 は， 次の 通りです. 
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表 デバイス ファイルの 入出力 方向 





入力 


出力 


CON 


可 


可 


PRN 


不可 


可 


NUL 


可 


可 



このうち NUL は， ダミー 入出力で あり， 入力 は 常に EOF 力ま 返され， 出力 は 実際に は 行なわれ 
ずに データ は 捨てられます. 



A) 高 7KHI 入出力 Rtt 

高水準 入出力 関数 は 文字 単位の 入出力が 基本で あり， テキス ト • ファイルの 処理が 簡単に おこ 
なえる ようになって います. 

高水準 入出力で は， 5 つの ファイル ポインタ， stdin (標準入力）， stdout (標準出力）， stderr (標 
準 エラ一 出力)， stdaux (標準 補助 出力)， stdprn (標準 プリンタ 出力） が ヘッダ ファイル stdio.h 
で 宣言され ており， プログラムの 起動時に これらの ファイル は， カーネル によって 自動的に ォー 
プン されます. stderr, stdaux は 標準 C では 入力， 出力と もに 可能です が， MSX-C の 標準 ライ 
ブラ リ では 構造 上 実現で きないので， 片方 向 （この場合 は 出力の み） になって います. 

高水準 入出力 関数で は ファイル は 通常 "テキスト" モードで 処理され ます. テキスト 'モード 
では 入力 中の CR-LF の 組合せ は 1 文字の ニュー ライン 文字 （¥n) に 置き換えられ， また， EOF 
文字 以降の ファイルの 内容 は 無視され ます. 逆に， 出力の 場合に は ニュー ライ ン 文字が CR-LF に 
戻され， EOF 文字が ファイルの 最後に 追加され ます. ただし， このような 変換が 望まし くないと 
きに は， ファイル を "バイナリ" モードで 処理す る こと もで きます. 

高水準 入出力 関数 を 使って いる 最中に， その ファイル は どの ファイル ハンドル を 使用して いる 
かが 必要になる ときが あります. 例えば， 出力 先が デバイスで あったら キー入力 待ち をしたい 時 
などです. その ときには fileno () (マクロ） を 使えば 対応す る ファイル ハンドルが 求まり ます. 
これで， 高水準 入出力 関数と 低水準 入出力 関数の 橋渡しが できます. 例えば， fopen() で オーブ 
ン した フ アイ ルがデ バイ ス かどう か を 調べる に は 

if (isatty(fileno(fp») 
デ パイ スの 処理 

else 

フ アイ ルの 処理 

とすれば よくなります. ファイル ハンドル を 得て， read ()， write () もで きます が， 高水準 入 出 
力 関数 は バッファ リ ング している ので データ 落ちに 注意し なければ なりません. 
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B) 裹 入出力 国 数の バッファリング 

高水準 入出力 関数 は 入出力す る データ を メイン RAM (MSX- DOS の TPA) 内に バッファ リ ン 
グ しています. 

バッファリングの 動作 を 簡単に 説明し ます， リード 動作に おいて は， まず バッファに データが 
あるか どうか を チェックし， あれば それ を 渡します， ない 場合に は ディスクから バッファが フル 
になる まで 入力 デーダ を 読み込みます. その 中から 要求の あった 分 を 先頭から 返します. ライト 
動作で は， 出力 データ を バッファに 書きた めて おき， バッファ がいつ ばいに なった 時点で デ イス 
クに 書き込みます. この 書き込み のこと を バッファ フル 時の バッファの フラッシュと いいます. 

ノ 《ッ ファ リングに は フル バッファリング， 行 バッファリング， バッファリング なしの 3 種類が 
あります. フル バッファリング は 上記の 動作 を そのまま 行います. この 方法 は ファイル を fopen 
() で オープン すると 採用され る 方法です. 行 バッファ リ ングは テンプレート 機能 力 《使える 1 行 単 
位での 入力 や， "¥n" が 出力され ると バッファ を フラッシュ する 方法です. 行 バッファリング は 入 
出力の 対象が デ バイ ス ファイル （コンソール など） 以外で は あ ま り 意味が あ り ま せん. 3 番目の バ 
ッファ リングな しで は， 入出力 要求 を 1 文字 単位で 対応し ます， デバイス ファイルの 場合に は そ 
の 時点での 状態が 見える ので 便利です. 

バッファ リングに はこの よう に 3 種類 あり ますが， 実際の ファイルの 入出力に は read () と 
write () を 使って いるので， MSX-D0S2 の 仕様が 直接 現れて しまいます. つまり， デバイス ファ 
ィル から 入力す ると 必ず 行 バッファ リ ング になって しまいます. 

ここです こし バッファの フラッシュ について 説明し ましょう. ノ 《ッ ファの フラッシュと は， あ 
る 時点で バッファに 残って いる データ を ディスクに 窗き 込む こと をい います. バッファ を フラッ 
シュ する ある 時点と は (1) バ ッファ がい つばい になった とき， （2) 行バ ッファ リングの とき "¥n "が 出 
力され たと き， （3) 高水準 入出力 関数で コンソールからの 入力 をした とき， （4) ユーザーが 明示的に 
フラッシュした とき， の 4 つがあります. （1) から (3) は 標準 ライブラリが 自動で 行います. （4) が必 
要な ときと は コンソールに メッセージ を 途中 の 状態で 表示 し たい 場合で しょう. プロンプト を 表 
示して そ の 行の 続 きから 文字 を 入力したい 場合に は (3) に よって 自動で 行わ れ ます. 

高水準 入出力 関数 を 使用す る 場合に は， FILE 構造体への ポインタ を 使用し ますが， この FILE 
構造体 は/ 《ッフ アリン グ 制御の た め の 情報が 入 つてい ます. ユーザー はこ の 情報の うち バッファ 
サイズ， バッファの 位置 そして バッファ リ ングの 方法 を setvbuf () で 変更す る ことができます. 
ただし， ファイル を オープン 後 データの 入出力が まだ 行われて いないと きで ない と 使用で きませ 

ん. 

MSX-C Ver ， 1 . 2 の 標準 ラ イブ ラリ では， main ( ) に 制御が 渡つ た ときには 5 個の ストリーム 
が 自動的に オープンされ ています， それらの ファイル 構造体への ポインタ は stdin, stdout, 
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stderr, stdaux, stdprn です.. このうち stderr と stdaux は バッファリング なしで， 残り は行バ 
ッ ファリ ングで オープンされ ています. 



C) 低水準 入出力 R 数 

低水準 入出力 関数 は， バッファリング せずに 直接 ディスクに データ を 読み書き します. そのた 
め データ 数が 少なく， 読み書きの 回数が 多くなる と 遅くな つてし まいます. データが まとまって 
いる 場合に は， 低水準 入出力 関数で も 十分に 速い 読み書きが できます， データの 入出力 関数が 
read ( ) と write ( ) しかありません ので， 文字 単位， 文字列と いう 考え方が できません. そのため 
バイナリ データな どの 処理に は 向いて いるでしょう. また， Ver. 1.1 にあった ような デバイス フ 
アイ ルに アクセスで きないと いうよう な 事 はなくな りました. 

4,3,5 文字列お よ TO 宇 処理 鬭数 

文字に 関する 関数 は 2 種類 あ り ます. 文字の 種類 を 判定す る ものと 文字 や 文字列 を 操作す る も 
のです. 

文字の 種類 を 判定す る 関数 は， 文字 を 与えて そ の 文字が 英小文字 か どうかと いうよう な 判定 を 
する ものです. これらの 関数 は ある 決まった 文字の 種類 （数値 を 期待して いる ときには 数字） で 
あるか どうかに 使います. この 判定 をす る 関数 は" is" から 始まって います. 

もう ひとつの 関数 群 は 主に 文字列 を 対象に しています. 文字列の 比較 や， 文字列 中から ある 文 
字 を 探すな ど 様々 です. これらの 関数 は" str" で 始まります. また， 文字 を 大文字 や 小文字に 変換 
する 関数 もあります. 他に， 文字列の 長さの 制限して 比較す る 関数 も あり， それらの 関数 名 は 
"strn" で 始まります. 
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4,3,3 メモリ 管理 関数 

MSX-C では メモ リ 管理 関数 は 1 種類 あ ります. ひとつ は 低水準 メ モ リ 管理 関数， もう ひとつ は 
高水準 メモリ 関数です. 



A)fl£7K« メモリ 管理 n 数 

低水準 メモリ 管理 関数 は 単純な メモリ 領域の 確保 関数 （sbrkO) と スタック 領域の 確保 関数 
(rsvstk ()) からなります. sbrk () は MSX-C で 使う プログラム や データの 領域の 最後 端から 
指定 さ れた 分の 領域 を 確保して いきます. rsvstk () は スタック 領域の サイズと して その 値 を グロ 
—バル 変数 _torelance に 保存し ます. sbrk () で 確保され る 領域 は， スタックの 方向へ 延びて い く 
ので， 確保の 際 は rsvstk () で 指定され た スタック 領域 を 侵さない かの チェック をし ます. CPU 
のス タック ポインタ SP は sbrk ( ) を 呼ぶ 状況に よ つ て 変化 し ま す 力、 呼ばれた ときの スタック 
ボイ ンタの 値から _torelance を 引いた 位置 （下図の B 点） が， 確保しょう と している 領域の 後端 
(A 点） と 重ならなければ その 領域の 先頭 （memtop) を 返します， 返した 後に memtop は A 点 
に セットされ， 次の sbrk () のために 準備 をし ます. （下図 は 領域 確保が 成功 するとき の 図です.） 



OOO0H 
0100H 



ページ 0 



プログラムと データ 領域 



メモリ 管理 領域 



memtop 



O すでに ユーザ一 に 渡った 領域 
O 使用され ていない 領域の 先頭 



OA 点 今の sbrk () で 確保され る 
領域の 後端 



SP 

TPA top 



スタック 領域 



MSX-DOS 

ワーク エリア 



OB 点 スタック として 確保され 
た 領域の 先頭 （SP- torelance) 



FFFFH 1 1 

図 メモリ 管理 関数の 割り当て 方 
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b) 高水準 メモ u« 理 n 数 

もう 1 種類の メモリ 管理 は， サイズな どの 管理す る 情報 を 準備して から 領域 を 渡す alloc () と， 
alloc () によって 渡さ れた 領域 を 解放 し， もう一 度 alloc () で 使える ようにす る free ( ) の 組で 
す. 普通の プロ グラムが 実行時に メモリ が 必要に な つ た 場合に は こ の 高水準 メ モ リ 管理 関数 を 使 
います. 高水準 メモリ 管理 関数 は ファイル 入出力の バッファ 領域 や， getenv () 関数な どで も 使わ 
れ ています. また， メモリ 管理 関数の 低 水舉と 高水準 を 混ぜて 使う こと もで きます が， 高水準 だ 
け を 使う ことで free ( ) したと き に 無駄の 少ない メ モ リ 利用が で きます. 

free () で 解放され た 領域で n バイ ト 以上の 領域がない 場合に は sbrk () で 領域 を 確保しょう 
とします. つまり n バイト alloc () し， 直後に そこ を free() してから， （n+m) バイト alloc ( ) 
しょうと すると （(n+sizeof (HEADER)) + (n+m+sizeof (HEADER))) 以上の メ モ リ が 必要 
になります. 

4,3,4 ディレクトリ M 数 

MSX-D0S2 では 階層 ディレクトリ が 扱 える ようになり ましたが， それ を サポート する ための 
関数が ディレクトリ 関数です. カレント ディレクトリの 移動 '獲 得， サブ ディレクトリの 作成' 
削除が あります. また， 階層 ディレクトリ を サポートした ワイルド カード （* や？） を 実際の フ 
アイ ル 名に 展開す る 関数 もあります， これら を 使えば MSX-DOS の コマンド 内から 階曆 ディ レ 
ク ト リ を 上手に 使える ことができる でしよう. 

4,3,5 プログラム 攥作鬮 数 

プログラムの 実行中， エラーな どで 処理が 続けられない 時， プログラム は 終了し なければ なり 
ません. しかし， 関数 をい くつ も 呼んで いたり （ネストし ている）， ファイルの オープン もして い 
るな ど 厄介な ことがあります. そのような 場合 ただちに プログラム を 終了す る 関数 も 用意して あ 
り ます. 

ひとつの プログラム では 終らない 様な 処理 も 考えられます. そのために プログラム 中から 別の 
プログラム に 実行 を 移す 関数 もあります. 

4,3.6 キー ポー ド， I/O 難 

高水準の 入出力 関数 はいろ いろな 機能が あり 便利です が， 〗 文字 入力 ごとに 反応 を 示す 必要が 

ある 場合に は， キーボード 直接 入力 関数と いう もの も 用意して あります.. また， MSX の 機能 を 
フルに 使いたい ときには 直接 周辺の LSI に コマンド を 出す I/O 関数 を 用意して います. 
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4,3,7 機氣 MSX - DOS ファンク ショ: ル ItTlt 一 卜 B 数 

MSX-C の 標準 ライ ブラ リに はさま ざま な 関数が あ り ま すが， MSX-DOS2 では， より 多く の 機 
能をサ ポー ト しています. それ を 使うた めに ファンクション コール サポ一 トの 関数 も 加えました, 
また そ の 関数 は， MSX-C 以外で 作成 し た 機械語の プロ グラムに も 利用で き ま す. 

4,3,8 メモ リ 撮 作 間数 

メモリ 操作 は MSX-C の 記述で もで きます 力、 メモ リ 内容の コピー な ど は 量が 多 くなる と 結構 
時間が かか つてし まう ものです. 高速 性が 求 めら れる ときには メモリ 操作 関数 を 使 うとい いでし 
ょラ， 

4,3.9 巩 用閧数 

上記の 他に も まだまだ 便利な 関数が あります. 環境 変数の 獲得 や 設定， データの ソートな ど， 
使えば c での コマンド の 範囲が 広がる も のば か り です. 

4.4 UNIX 糠 準 c ラ 々ラリ との 相 ais 

以下の 関数 は， UNIX の 標準 C に 対応す る 関数が あります. ただし， "*" の 付いた 関数 は， 幾 
分 仕様が 異なって います. また， "-" の 付いた 関数 は， 標準 C の サブセット になって いますので 
利用 時には， 若干の 注意が 必要です. 



abs 


atoi 


chdir 


clearerr 


close * 


creat 


eof 


execl * 


exexlp * 


execv * 


execvp * 


一 exit 


exit 


fclose 


fcloseall 


feof 


ferror 


fflush 


fgets 


fileno 


flushall 


fopen * 


fprintf - 


fputs 


fread 


free 


f scanf - 


fwrite 


getc 


getchar 


getcwd 


getenv 


gets * 


isalnum 


isalpha 


isatty 


iscntrl 


isdigit 


islower 


isspace 


isupper 


isxdigit 


longjmp 


mkdir 


open 


printf - 


putc 


putchar 


putenv 


puts * 


qsort 


read 


rename 


rmdir 


sbrk 


scanf - 


setbuf 


setjmp 


setvbuf 


sprintf - 


sscanf - 


strcat 


strchr 


strcmp 


strcpy 


strlen 


strlwr 


strncat 


strncmp 


strncpy 


strupr 


tolower * 


toupper * 


ungetc 


ungetch 


unlink 


write 










90 



第 4 章 MSX-C 標準 ライブラリ 



以下の 関数 は， MSX-C にの み 存在し ます. 



alloc 


bdos 


bdosh 


bios 


call 


calla 


callxx 


expargs 


fsetbin 


fsettext 


getch 


getche 


inp 


iskanji 


iskanji2 


kbhit 


max 


memcpy 


memset 


min 


movmem 


outp 


rsvstk 


sensebrk 


setmem 



4.5 ラ<7 ラリの 作成と 保守 



4.5.1 MSX-C ライブラリの 構成 

MSX- C に は， 次の 4 つの. rel ファイルが 用意され ています. 

ck.rel 力一 ネ ル 呼び出 し ルーチン 

clib.rel 標準 ライブラリ （カーネル 本体 を 含む） 

crun.rel 実行時 ルーチン 

cend.rel 標準 ライブラリ 

ck.rel は カーネル を 呼び出す ルーチンが 含まれて います. カーネル 本体 は clib.rel に 含まれて 
おり， ck.rel では それ を 呼び出し ています， MSX-C における 「カーネル」 と は， ユーザー プ ログ 
ラム を 実行す る 際の 環境 を 整備す るた めの プログラムです. カーネル は， 次の ような 働き をし ま 
すが， 処理の 大部分 は 次に 述べる CLIB 内部の プロ ダラ ム を 呼び出す こ と で 行って いま す. 

(1) まず， コマンド 行 を 解析し， argc と argv を セットす る. 

(2) 標準入力 （stdin), 標準出力 （stdout), 標準 エラー 出力 （stderr), 標準 補助 出力 

(stdaux), 標準 プリンタ 出力 （stdprn) の 5 つの ファイル を オープン する. 

(3) ユーザ一 プログラム 中の 関数 ma i n に 制御 を 渡す. 

(4) main ( ) の 実行の 正常終了 や exit ( ) の 呼び出 しによ つて ユーザー プログラム の 実行が 終了 
すると 制御 は カーネルに 戾り， そのと き 開かれて いる ファイル をす ベて クローズ する. 

ck.rel の ソースファイル は ck,mac， カー ネ ル本 体の ソース プログラム は process.c に 関数 _niain 
() として 言己述 されて います. 
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clib.rel は MSX-C の 標準 ライブラリです. すなわち， printf ( ) や atoi ( ) などの 標準 ライ ブラ 
リ 関数 あるいは 内部 関数の 集まりです. リンク 時には， ユーザー • プログラム 中で 使用して いる 
関数 だけが ライ ブラ リ から 抽出され ます. 

ソース プログラム は， 次の 8 個の C 言語 ファイル， 1 個の アセンブリ 言語 ファイルに 収められて 
います. 



clibc.c 


clibmac.mac のス ケルト ン 作成 用 ファイル 


direct.c 


ディ レク ト リ 操作 関数 ソースファイル 


io.c 


低水準 入出力， キーボード 関数 ソースファイル 


mallocx 


メモリ 管理 関数 ソースファイル 


process.c 


プログラム 管理 関数 ソースファイル 


stdio.c 


高水準 入出力 関数 ソース フ アイ ル 


stdliox 


汎用 関数 ソースファイル 


string.c 


文字列 操作 関数 ソースファイル 


clibmac.mac 


標準 ライ ブラ リ 関数 アセンブラ 記述 部 



ソース プログラムが 提供され ている ことによって， ユーザー は， 独自の カーネル を 作ったり， 
標準 ライ ブラ リ 関数 を 差し替えたり， それ を 参考に して 独自の 関数 を 追加した りする こと が 容易 

になります， ライブラリの 作成に ついては 「4.5.3 専用 ライブラリの 作成」 を， 標準 ライブラリ 
の 保守に ついては 「4.5.4 標準 ライブラリの 再 作成」 を 参照して ください. 

また， 標準 ライブラリ 関数に 関する もう 1 つの ファイル lib.tco は， FPC (関数 パラメータ' チ 
エック. ユーティリティ） で 使用す るた めの ものです. この ファイルに は， すべての 標準 ライブ 

ラ リ 関数の 型と 引数に 関する 情報が 含まれて います. 

crun.rel は C プログラムの 実行時に 必要な サブルーチンの 集まりです. 乗算， 除算な どの （CPU 
に 対応す る 命令がない） 演算 は， コンパイラ によって CRUN 中の サブルーチンの 呼び出しに 置き 
換えられます. CRUN は， このように 言語 仕様と ハードウェアの 差 を 補うた めの もので， 他に シ 
フ ト 演算， 符号 付 き 比較な どの サブルーチンが あります. ソースファイル は crun.mac です. 

cend.rel は 標準 ライ ブラ リの 一部と 考えて 下さい. これ は 最後に リ ンク する モジュールで， 以降 
が ヒープ 領域と なり ます， ソースファイル は cend.mac です. 
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4.5,5 ラゎラ リ倮守 支援, クール MX について 

ライブラリの 作成， 保守 を 行う 場合に は， MX (モジュール 抽出 ユーティリティ） を 使用して 
ユーザ一 が 実行し なければ ならない 処理の 効率 を 大幅に 向上させる ことができます. 

MX は， 具体的に は 次の よう な 操作 を 行います. 

(1) 中間 言語 ファイル （.tco ファイル） または アセンブリ 言語 ファイルから モジュール （関数） 
を 抽出す る. 

(2) 抽出 した モジュールの コード 生成， ァ セン ブルな ど の 手順 を 標準出力 に 出力す る. 

すなわち， 複数の 関数 を 含む ファイルから 任意の モジュール を 引き だしたり， モジュール ごと 
に 別々 の ファイル を 作成す る ことが 可能で， ライブラリの 保守， 作成が 非常に 楽になります. ま 
た， そのための 手順が 標準出力に 出力され るた め， それ を. bat ファイルに リダイレクト すれば， 
そのまま バッチ ファイル として 使用す る ことができる ようになります. 

MX の 書式 を 次に 示します. 

MX [オプション] ファイル 名 [モジュール 名] .•• 

ファイル 名 は 拡張 子な しで 与えます. MX は， 指定の ファイル 名 を 持つ. mac ファイル を 探し, 
見つかった 場合に は それ を アセンブラの ソースファイルと 見なして 作業 を 開始し ます， . mac フ 
アイ ルが 見つからな いと， MX は 指定の ファイル 名 を 持つ. tco ファイル を 探し， 見つかった 場合 
に は それ を C の 中間 言語 ファイルと 見なして 作業 を 開始し ます. 

その ファイルから 引き出すべき モジュール は， ファイル 名の 後に 指定し ます. ここで は ひとつ， 
あるいは 複数の モジュール を 指定す る ことができます. また， モジュール 名に は ワイルド カード 
文字 （* と？） を 使用す る ことができます. モジュールの 指定 を まったく 行わない と， すべての 
モジュールが 抽出され ます. 

MX は 実行時に， 2 つの バッチ フ アイ ル arel.bat， crel.bat が カレント ドライブの カレント ディ 
レクト リ に 必要です. この 2 つの ファイル は， MX の 出力の 変更 を 容易に する も ので， arel.bat は 
アセンブリ 言語 フ アイ ルか ら. rel フ アイ ル への 手順 を， crel.bat は 中間 言語 （.tco) フ アイ ルか ら . 
re】 フ アイ ル への 手順 を 示して います. MX は ファイル 中の" ％1" を モジュール 名に 変換して 出力 
します. 

カレント ディレクトリに， arel.bat, crel.bat が 見つか ら ない 場合に は， nix,com のあった ディ 
レク ト リ を 探します. それでもない 場合 は" Skeleton file く filename) not found "と 表示して 終 
了し ます （く filename) は arel.bat か crel.bat). よ く 使われる 形式の arel.bat, crel.bat を 鼠 
com と 同じ ディ レク ト リに 置いて おけば， 存在 を ほとんど 意識し ないです みます. 違った 形式の 
もの を 使いたい 場合に は， カレント ディレクトリに arel.bat, crel.bat を 置いて おけば それが 使わ 
れ ます. 
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"ジョン 

-I LIB80 を 呼び出 して ライ ブラ リファイ ルを 作成す る 出 順 も 出力. 

この オプション を 指定 しないと， .re】 ファイル を 作成す る ところまでで 出力 を 終 
了し ます. 

- o [path¥] 分割した モジュール を ディ レクト リ path に 抽出す る. 

ディ レク ト リの 指定 は 必ず，， ¥ "で終 つてなければ なりません ノ， ¥ "で 終って なけれ 
ば ，，-1" スィ ツチ 使用 時の ライ ブラ リファイ ル 名の 指定と なります. ただし， 抽出 さ 
れる ファイル は ライ ブラ リファイ ルと 同じ ディ レク ト リ となります. この ォプシ 
ヨン を 指定 しないと， カレント ドライブの カレント ディ レク ト リに モジュール を 
抽出します. 

MX での エラー メ ッ セージ は コマンドの 動作に ついての メ ッ セージです. 例えば， .tco や .mac 
ファイルが 見つからな いなどの メ ッ セージです • このような メ ッ セージが 表示され た ときには， 
MX は 処理 を 中止して コマンド レベルに 戻ります. 実際の エラーメッセージ は 「8. 4 MX の エラ 
—メッセージ」 を ご覧 下さい. 

MX の 具体的な 使用例に ついては， 「4.5.3 専用 ライブラリの 作成」 を 参照して ください • 

4-5,3 奪 用 ライブラリの 作成 

「ライブラリ」 に は， （1) リンク 時に すべての 関数 を 実行 ファイルに リンクす る もの， （2) リンク 
時に 必要な 関数 だけ を 実行 ファイルに リンクす るよう にした もの， の 2 種類が あります' それ ぞ 
れの. 長所と 短所 を 挙げる と， 次のようになる でしよう. 

(1) 長所： 簡単に 作成で きる. 

短所 ； プログラムで 使用し ない 関数 も 含めて， ファイル 中の すべての 関数 を 実行 ファイル 

にリ ンク してし まう ので， 実行 ファイルが 大きくな つてし まう. 

(2) 長所： プログラムで 使用す る 関数 だけ をリ ンク する ため， 実行 ファイルの オブジェクト 効 

率が 向上す る. 
短所 ： 作成す るのに 手間が かかる • 

通常 「ライブラリ」 という 場合に は (2) のよう な ライブラリ を 指し， MSX-C の clib,rd， crun.rel 
もこの ような' 格 を 持って います • （1) のよう な ライブラリの メ リツ' トは， 手軽に 作成で きる とい 
うこと 以外に はないた め， 極力 (2) のよう な ライブラリ を 作成す る ことが 推奨され ます' ここで も 
(2) の 説明 を 中心に 行います が， まず はじめに 基礎と して (1) の ライ ブラ リ の 作成 方法 を 簡単に 述べ 
てお きます. 
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A) すべての BMS を リンクす る ラ<7 ラリ 

次の ような 2 つの 関数 power ()， log2 ( ) を ライブラリに する， という こと を 考えて みまし よ 
0. 

int power (x, e ジ 
int x, e; 
{ 

int y; 

for (y = 1； e > 0； e --) 

y *= x; 
return (y); 

} 

int log2(x) 
int x; 
{ 

int y; 

for (y = 0； x > 1； x »= 1) 
y++; 

return (y); 

} 

これらの 関数 は） dib.c という ソースファイルに 入って いるもの とする と， ライブラリ を 作る 手 
順 は 次のようになります. 

A>cf xlib0 
A>cg xlib0 
A>«80 =xlib@ 
A>del xlib,uac0 

以上の 手順に よって， xlib.rel が 作られます. これで ライブラリ XLIB の 作成 は 終りです. ュ一 
ザ 一の プログラム を prog と したと きに， この ライ ブラ リ を 使う リ ンクの 手順 は 以下の よ うにな 
り ます. 

A>180 ck, prog, al ib, c I ib/s, orun/s.cend, prog/n/e: xiaain @ 

この場合， xlib の 後に/ s (必要な 関数 だけ を リンクす るた めの スィッチ） は 不要です. それ を 
指定しても 結局 はすべ ての 関数が リンク されて しまう から です. 
アセンブラで 書かれた プログラムの 場合 も， 同じよう にして ライブラリ を 作成したり， 使用し 
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たりす る ことができます. 次の ような 3 つの 関数 hex ()， ror()， rol () について 考えて みまし 
よう （ファイル 名 は alib.mac とします）. 



rope: 
rorl' 



rol«: 
roll: 



inc 

dec 
ret 
rrca 
jr 



inc 

dec 
ret 
rica 
jr 



； ror(c,n) 
e 

e 
z 

rorl 

； rol(c,n) 
e 

e 

2 

roll 



= rotate c right n bits 



= rotate c left n bits 



これらの 関数 を ライブラリ 化する 手順 は 以下 のようになります. 



A>n80 =alibP1 



リンクす る 手順 は， C の 場合 と 同様 に 次のようになります， 



A>180 ck,prog,xlib,cIib/s,crun/s,cend,pro8:/n/e:xBaini^j 



以上の ように， 「必要な もの だけ を リンクす る」 という 機能 を あきらめて しまえば， ライブラリ 
作成 はいたって 簡単な ものと なります. しかし， やはり これで は 完全な ライブラリと は 言え ませ 
ん. 以下で は， 必要な 関数 だけ を リンクす るよう な ライブラリの 作り方に ついて 述べます • 



public hex9,ror0,rol© 



cseg 

hexe: 



； hex(c) = convert 0 - F to ASCII ，0， - ,F 

OFH 

a.90H 

a,40H 



d d a c a t 

n d as d & e 

ov a tQ <a Jo r 
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B) 必要な H 数 だけ を リン <TT る ライブラリ 




エディタ 



•c ファイル 



(ii) 



CF 



.tco ファイル 



(III) 



MX 



(IV) 



.tco ファイル 



,tco ファイル 



CG 



.mac ファィ ノレ 



アセンブラ 
M80 



.rel ファイル 







ヽ 




CG 


— 


r ~ 


r— —― 

し. mac ファイル 


、 


/ 


アセンブラ 
M80 


^ 


T ^ 


、 ヌ 

rel ファイル 

L — ^ —- 



.tco ファイル 







、 




CG 



.mac フ アイ ノレ 



、 


f 


アセンブラ 

M80 











.rel ファイル 




ライブラリアン 
し 旧 80 



.lib フ アイ リレ 



プログラム 作成 



C 言語 ソース プログラム 



中間 言語 ファイル 

関数 ごとの. tco ファイル 
に 分割す る。 

(モジュール 抽出 ユー ティ リ ティ） 
関数 ごとの. tco ファイル 



関数 ごとに コンパイル 
(コード 生成） 



関数 ごとの アセンブリ 言語 
ファイル 

関数 ごとに アセンブル 



関数 ごとの オブジェクト 
ファイル 



ライブラリアン によって 複数 
の オブジェクト ファイル を 連結 



必要な （参照して いる） 関数 
を 抜き出せる ライ ブラ リファ 
ィル 



図 専用 ライブラリ 作成の 手順 
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さて， ライブラリの 作成 法に ついて 説明す る わけです が， その 前に 作業に 当って 必要と なる 環 

境 を 定義す る ことにしましょう. （「4.5.4 標準 ライブラリの 再 作成」 で 使う forremk.bat を 使用 
して 環境 だけ 整えても いいでしょう.） 

まず ディスク 装置 は 2 台 ある ものと します （A: および B:)， B ドライブ は 空に してお いて 下 
さい. A ドライブに は， 以下の ファイルが 必要です. 

ユー ティ リ ティ ソフトウェア 
m80.com 
180.com 
Hb80.com 

MSX-C コ ン パイ ラ パッ ケージ 

cf. com 

cg. com 
fpc.com 
mx.com 
arel.bat 
crel.bat 

このほかに スクリーン エディ タが ある と 便利です. 

先 ほどと 同じく， power () と log2 ( ) の 2 つの 関数 を 持つ ファイル xlib.c を ライブラリ にして 
みましょう. 

まず， xlib.c を エディタ によって A ドライブに 作成して 下さい. （97 ページ 図の (1)) そして 以 
下の コマンド を 入力し ます， 

A>cf xlib0 97 ページ 図の （II) 

A>nx -lob xlib > temp. bat 0 97 ページ 図の （III) 

A>teap g) 97 ページ 図の （IV) 

CF は xlib.c から xlib.tco を 作成し ます ♦ 次に， MX が xlib.tco から power.tco と log2.tco の 
2 つの モジュール を 取り出し， B ドライブに それら を 置きます. 
また， このと き MX は， 

(1) これらの ファイル に対して， コード 生成 を 行なって， .mac を 作る. 

(2) アセンブル を 行なって， .rel を 作る. 

(3) LIB80 を 起動して 2 つの. rel を 連結す る. 

という 手順 を 標準出力に 出力す るので， それ を そのまま temp.bat という ファイルに リ ダイ レク 
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卜し， すぐに temp を 実行して います. 

これらの 処理が 完了す ると， B ドライブに xlib.lib という ファイルが できて います. その他に， 
power.rel と log2.rel という フ アイ ルがぁ り ますので， これ を 

A>del b:*.rel@ 

で 削除して 下さい. その後に 

A>ren b:xlib.lib xllb.rel0 
とすれば， 目的の ライブラリが 完成し ます. 
この xlib.rel の 使い方 は 以下の よう にな り ます. 

A> 180 ck ， prog , x 1 i b/s , c 1 i b/s , crun/s , cend ， prog/n/ e:xmainl^j 

xlib の 後 のん は 必要です. これ を 付ける ことにより， リンカ は 必要な 関数 だけ を リンクし てく 
れ ます. 

リンカ L80 を 使用す る 場合 は， 関数 を 定義す る 順序が 問題と なる ので 注意して ください. たと 
えば， 

(正しい 例） 

char is lower (c; 

char c; 

{ 

return ('a' <= c && c <= ，z ，バ 

} 

char toupper(c) 

ch&r c; 

{ 

return (islower(c) ？ c - 'a* - ，A， ： c); 

} 

という 2 つの 関数から なる フ , ィル x.c を ライブラリに したと しましょう. このと き， もし x.rel 
の 中で， islower () が toupper () よりも 先に 置いて あると， L80 でん オプション を 付けて リンク 
したと きに， 未定義 エラーと なります. 

実際に は， MX は ソース プロ ダラ ム 中の 順番 と は 逆に . rel を 連結 します ので， islower ( ) を 先に 
書いて おけば 正しい ライブラリが 作られ ますが， 下の ように toupper () を 先に 書く と， ライ ブラ 
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リ 中の モジュール は 誤った 順序で 配置され てし まいます， したがって， ライブラリの ソース プロ 
グラムで は， 呼び出される 関数 を 先に， 呼び出す 関数 を 後に 置く ようにして ください. 

(誤った 例) 



char toupper(c) 

char c; 

{ 

char islowerO; 

return (is lower (c) ？ c - 'a' - T ： c); 

} 

char is lower (c) 

char c; 

{ 

return ('a， <= c 4& c <= ，z，）； 

} 

次に， アセンブラで 書かれた プログラム を ライブラリに してみ ましょう. 前述の hex()， ror 
()， rol 0 の プログラム を 使用し ますが， プログラム は 以下の ように 変える 必要が あります. こ 
れを alitunac という 名前で A ドライブ 上に 作成して 下さい. 

MODULE HEX 
public hex© 

hexO: 



ENDMODULE 

MODULE ROR 

public rorO 

ror©: 

inc e 

rorl: 

dec e 

ret z 
rrc& 

jr rorl 

ENDMODULE 

MODULE ROL 

public rolO 



OFH 
a,90H 

a,40H 



d d a c 0^ t 

n d a d a e 

a a d a d r 
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rolo: 

inc e 

roll: 

dec e 
ret z 
rlca 

jr roll 
ENDMODULE 

これ を ライブラリ にす るに は， 次の よ うに コマンド を 入力す る だけです. 

A>»x -lob alib > temp. bat l£) 
A>tenp@ 

すると， MX は alib.mac から hex.niac, ror.mac, rol.mac を 引き出し， 作成され た バッチ フ 
アイ ル temp が それら を アセンブルして. rel を 作 り ， LIB80 を 呼び出 して 連結し ます. 

すべてが 完了す ると B ドライブに は alib.lib がで きてい ますので， 作成され た 不要な 他の. rel 
フ アイ ルを 消して か ら alib.rel に 名前 を 変更 すれば， ライブラリ の 完成です. 

C の 場合と 同様， L80 リンカ を 使う 場合に は， モジュールの 順番が 問題になります. ソース プロ 
グラムで は， 必ず 呼び出される 方の モジュール を 先に， 呼び出す 方の モジュール を 後に 書いて お 
いて 下さい. 

ライブラリ 自身の 作成 方法 は 上記の とおりで すが， もう ひとつやるべき ことが 残って います， 
それ は FPC. に 与える パラメータ チヱ ック 用の ファイル を 作る ことです. 
こ れ は 以下の 手順で 作成 します. 

(1) ライ ブラ リ 用の C の ソース プログラム に対して CF を 実行して. tco ファイル を 作る. 

(2) アセンブラで 記述した ソース プログラムが ある 場合， それらの 関数の 型お よび パラメータの 
型 を C 言語で 表現した フ アイ ルを作 り， CF によって. tco フ アイ ルに する. 

(3) FPC の" -c ，，スィッチ を 用いて， a)， （2) で 作った. tco ファイル を 圧縮して 連結す る. 

例と して， 前述の xlib.c と alib.mac チェック 用 ファイル を 作って みましょう， まず， 

A>cf xlib 

によって xlib.tco を 作り ます. 

次に， alib.mac の パラメ一 タを， C の プログラムで 表現し ます. alib.c と して， 以下のような も 
の を 作って 下さい. 
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char 
char 
{} 



hex(c) 
c; 



char 
char 
int 

{} 



ror(c, n) 
c; 



char 
char 
int 
{} 



rol(c f n) 

c; 

ni 



この ファイルから， 次の コマンドで alib.tco を 作成し ます. 
A>cf alib@ 

最後に， 

A>fpc -c axlib xlib alib0 

と すれば， チェック 用の ファイル axlib.tco が 完成 します， 

さて， これまでの 説明で は ライブラリ を 新たに 作成す る 方法が 述べられました が， ライブラリ 
中の 1 つの 関数 を 修正した いような 場合に， ライブラリ 全体 を 作り直す の は 効率的で はあり ませ 
ん,， 

以下で は， 既存の ライブラリ 中の 関数 を 差し替える 方法に ついて 説明し ます. 

ここで も xlib.c を 例に とって 説明し ます. power ()，log2 () という 2 つの 関数から なるこの フ 
アイ ル のうち， 関数 power のみ 変更した とします. このと き， ライブラリ ファイル xlib.rel 中の 
power () を 新しい ものに 交換す るた めの 手順 は， 次のようになります. 

A>cf xlib0 

八>塑乂 一 ob xlib power > te 雇 p*bati£j 

A>te 雇 p @ 

A>lib80@ 

*b: H b=b : x 1 i b く • • power- 1> , b ： power ， b : x 1 ib<power+ K.>@ 



これまでの 例で は， MX に対して- 1 オプションが 指定され ていました 力、 ここで は 指定して い 
ません. -1 を 指定 しないと， MX は LIB80 に対する 手順 を 標準出力に 出力し ません また， xlib 



*/e0 
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の 後に power を 指定して いるた め， MX は 関数 power () だけ を 抽出します. 

また， LIB80 に対する コマンド （最後の 2 行） は， 「古い xlib.rel から power () 以外の モジュ 
—ルを 抽出して， それら を 新しい power.rel と 連結せ よ j という 指定です. このと き， モジュール 
の 順序が 変って しまわな いように 注意して ください. 

4.5,4 櫬準 ライブラリの 再 作成 

以下に 示す 方法で 作られる ライ ブラ リ は clib.rel, crun.rel として システム ファイルに 含まれて 
います. 通常の 使用で は， これらの ライブラリ を 新たに 作り直す 必要はありません. 

標準 ライ ブラ リ の 再 作成に は 1 枚の 未使用 ディ ス ク が 必要で， 1 台の ドライ ブで 実行可能です. 
また ライブラリ の 作成 は 約 2 時間 かかり ますので， 変更 を 行う 場合 は 変更 部分 を 良く テス ト して 
から 行う こと をお 推め します， （1DD の ドライブ 1 台で は， 容量 不足の ため 実行で きません. ドラ 
イブ 2 台で 行う か， 2DD の ドライブ を 用意して 下さい.） 

再 作成 用の ディ ス ク を 作る に は， MSX-C コ ン パイ ラ に 付属す るバ ツチ ファイル forrenik.bat 
(ディレクトリ ¥batch 内に あります.） を 使用し ます. FORREMK の 使用方法 を 説明し ましよ 
ラ. 

(1) 新しい ディスク を フォー マツ ト します. 

(2) フ 才ー マット さ れた ディ スクに forremk.bat を コピーし ます. B ドライ ブに MSX-C の マス 
ター ディスクが あると すると 次のようになります. 

A>copy b: ¥batch¥f orrenk. bat @ 

(3) コ ピーした ディスク を A ドライブ にいれ， 次のように コマンド を 入力し ます. 
A>forrenk b0 

(4) あと は プロンプトに 合わせて， MSX- D0S2 の システム ディスク など を B ドライブに 入れて 
いきます. 

以上で 再 作成 用の ディスクが できます. 2 ドライブ シミュレータ を 使って いる 場合に は， "Insert 
disk for drive く d ： 〉 "という メッセージが 出てから ディスク を 交換して 下さい. 

再 作成 用の ディスクが でき ましたが， これから コンパイル する わけです から， 環境 (環境 変数） 
を 整える ために， 必要で あれば CENV を 実行して ください， （これに ついては r l. 3 MSX-C の 
開発 環境 （開発 墚 境の 構築)」 も 参照して 下さい.） 
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出来上がった ディスクに は 次の ような ファイルが 入って いる はずです. （A ドライブに デ イス 
クが あると します.） 



a ： ¥ (ルート ディ レク トリの 内容) 



iorremk.bat 


しの アイ スク を 作成す るた めの ノヽ ツナ 7 アイ, レ 


msxaos2 . sys 


MSX-DUb2 ノス アム フ アイ ノレ 


commana^ . com 


ノノ 


cubc.c 


clibmac.mac の スク ノレ 卜 ノ 成 ffl ノアつ ノレ 


direci.c 


ネク、 ノ 力 1 11 iSt/fy^H^iHit v I づづ— ノ" 
アイ レク 卜リ 探 1卞阅 敛 ノース ノア イノ レ 


10.C 


低 水準 人出 力， キー ボー ト 関数 ソース ノア イノ レ 


malloc.c 


メセリ 官埋 関数 ソース フ アイ ノレ 


processx 


7 口 y フ ム営埋 関数 ソ一 スフ アイ ノレ 


stdio.c 


「1^"， レ淮" J Lt'+»Hfl*fr 、ク マつ— ノ i， 

咼ホ準 人 tb 『ノ: f 関 奴 ノース ノアつ ノレ 


stdlibx 


i/tx m Hfl*ff 、 / マ つ— ノ,， 
リ も 用閱数 ノース ノア イスレ 


string.c 


JQ^yuWfFmlwL ノース ノアつ ノレ 


ck.mac 


>1 ,n?i7 ft? 山 1 ii . ゝノ、 ク づづ— ノ i、 
77 — 不 ノレ 1ザ ひ & し ノレ 一 ァノ ノース ノアつ ノレ 


clibmac.mac 


jM^^t J -f^r 11 胡 新 マ v ゝノ ザら さコま 加 

フづ ノフリ 阅效 /セン ノフ sci:id53]S 


crun.mac 


t±7^^tt±L < 、ノ、 > づ— 》 —ノ" 
夹 f 了 時 ノレ ーテ ノ ソース ノアつ ノレ 


cend.mac 


標準 ライ ブラ リ 関数 アセンブラ 記述 部 2 


cenv.bat 


MSX-C の 環境 を 整える バ ツチ ファイル 


genlib.bat 


標準 ライ ブラ リ 再 作成 開始 用バ ツチ ファイル 


genliba.bat 


アセンブリ 言語 用 再 作成 バ ツチ ファイル 


genlibc.bat 


C 言語 用 再 作成 バ ツチ ファイル 


genrel.bat 


ライ ブラ リ .rel ファイル 再 作成 用 バッチ ファイル 


gentco.bat 


ライブラリ ，tco ファイル 再 作成 用 バッチ ファイル 


arel.bat 


MX 用 スケルトン ファイル （アセンブリ 言語 用） 


crel.bat 


MX 用 スケルトン ファイル (C 言語 用 ） 



a ： ¥bin (コマンドの ディ レク ト U¥bin の 内容） 

m80.com アセンブラ 

lib80.com ライブラリアン （ライブラリ 管理 ユーティリティ） 

cf. com コンパイラ （バーサ） 

cg. com コンパイラ （コード ジェネレータ） 
fpc.com ファンク ショ ンノく ラメ 一タ チェッカ 
mx.com モジュール 抽出 ユー ティ リ ティ 

a ： ¥include (ヘッダ ファイルの ディ レク ト リの 内容） 

bdosfunc.h MSX-D0S ファンクション コール 用 ヘッダ 

conio.h キー ボー ド • I/O 関数 用へ ッ ダ 

ctype.h 文字 種 判断 関数 用へ ッ ダ 
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direct.h ディレクトリ 操作 関数 用へ ッ ダ 

io.h 低水準 入出力 関数 用 ヘッダ 

malloc.h メモリ 管理 関数 用へ ッ ダ 

memory.h メモリ 操作 関数 用 ヘッダ 

process.h プログラム 操作 関数 用へ ッ ダ 

setjmp.h setjmp 用へ ッ ダ 

stdio.h 高水準 入出力 関数 用へ ッ ダ 

stdlib.h 汎用 関数 用 ヘッダ 

string.h 文字列 操作 関数 用へ ッ ダ 

typeh MSX-C 標準型の 定義 用へ ッ ダ 

環境 変数の 設定 

INCLUDE a ： ¥include 

PATH a ： ¥ ； a ： ¥bin 



ライブラリ の 再 作成 用 の ディスクが できました から， 再 作成 起動 用 の バッチ ファイル genlib. 
bat の 使用方法 を 説明し ましょう. できた ディスク は A ドライブに あると します. GENLIB 引数 
に は， 標準 ライブラリの 再 作成され る ドライブの， ドライブ 名 （B ドライブなら'' b" の 1 文字） だ 
け を 指定し ます. A ドライブに 作成す るので あれば 

A>genlib ai^fj 

と 入力し ます. ここで は カレント ドライブと 同じ A ドライブに 作成し ます. 次のように 入力して 
下さい. 

A>genlib a(±£j 

あと は バッチ ファイルが 自動的に ライ ブラ リ を 作成して いきます. 全体 は 11 個の 部分から なり， 
それぞれの 部分が 始ま る ごとに， 作成しょう としてい るフ アイ ルの 名前 を 表示し ます， 



Maxe process. lib from process. c 

Make direct. lib from direct. o 

Make stdlib.lib from stdlib.c 

Make stdio. lib fron stdio.c 

Make string. lib from string. c 

Make io. lib froa io.c 

Hake ualloc. lib from nalioc.c 

Make clibnac. lib fron clibnacmac 

Hake crun. lib from crun.mac 

Hake .rel file for linker L80 

Make .tco file for parameter checker FPC 
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これ 以外に も コンパイル 中の 表示 もされます， 正常に 動作して 終了した 時には， 次の よう 



また， 



に 表示され ます, 



MSX - C function parameter checker ver 1.20x 
conplete 

A> 

なお， ライブラリ を 拡張 したと きに ディスク スペース が 不足 し た 場合に は， 2 台の ド ライブ を 使 
用して 下さい. A ドライブに 上記の ディスク を 挿入し， B ドライブに は 空の ディスク を 入れて， 
次の コマンド を 入力し ます. 



A>genlib b@ 



.rel ファイル および 最終的な ライ ブラ リ は B ドライブに 作られます. 
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第 5 章 MSX-C コンパイラの 応用 

5.1 Disk-BASICBWRg) マ シ:/ チン (Pff 成 

ここで は， Disk-BASIC で サブルーチン として 用いる ための マシン 語 プログラムの 作成 方法 を 
述べます. 

5.1.1 Disk-BASIC 環 W と USR M 数 



A)Disk-BASIC の メモリ • マップ 

まず， 図 6-1 を 見て 下さい. これ は Disk-BASIC 起動時の メモリの 状態 を 示した ものです， こ 
れを 見る とわ かる よ う に， Disk-BASIC の ユーザー ェ リ ァは， BASIC ィ ン ター プリ タの 領域の 終 
了ァ ドレスの 次の ァ ドレスから ディスクの ワーク 'エリアの 開始 アドレスの 一つ 前の アドレス ま 
でです. 

ユーザー 'エリアの 開始 アドレス は MSX2 の 場合， 8000H 番地です が， ディスク • ワーク -ェ 
リアの 開始 アドレス は 実装 されて いる ディスク • ドライ ブの数 や 種類 により 異なります. 

現時点で は， 2DD (両面） フォーマットの ディスク • ドライブが 2 機 装備され ている 場合 や， 
1 機で も 2 ドライブ' シミュレータが 機能して いる 場合に， 最も 大きな ディスク • ワーク 'エリア 
が 取られます. その 場合の ディスク • ワーク' エリアの 下限 は， Disk-BASIC バ一 ジョン 1.00 で 
は DE70H 番地 前後， バージョン 2.00 では E580H 番地 前後です が， Disk-BASIC 起動 直後に ヮ 
ーク' エリア： HIMEM (FC4AH と FC4BH 番地） の 内容 を 確認す る ことで 正確な 番地 を 知る こ 
とが 出来ます ので， 安全の 為に 確かめて おくのが よいでしょう. 



B) マジ: /Hff 域 (DM 保と US 闩 

Disk-BASIC 環境 下での マ シ ン語フ ァ ィ ルの 読み込みから， USR 関数 を 用いて 実行す るまで 
の 手順 を 以下に 示します. 

(l)CLEAR 文で マシン 語 プログラム を ロードす る エリア を 確保す る. 

ユーザ一 • エリ ァの 上限 ァ ドレスが， CLEAR 文の 第 2 パラメータで 与えられた ァ ドレスに 
設定され ます. 例えば 

100 CLEAR ,&HCFFF 
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と すれば 変数 や スタック 領域 も 含めて BASIC の プログラムが 使える 領域の 上限が CFFFH 
番地 （新しい HIMEM — 1) までとな り， D0OOH 番地から 元の ユーザー' ェ リ ァの 上限まで が 
マシン 語の プログラム を ロードす るた めに 確保され たわけです. この 領域の 広さ は 読み込む 
マシン 語 ファイルの 大きさに よ り 設定し ます. 



0OOOH 



8000H 



F380H 
FFFFH 



BASIC インター 


-プ リタ （ROM) 


ユーザー 


'エリア 


ディスクの ヮ 


ーク • エリア 


システムの ヮ 


—ク • エリア 



O (BOTTOM) 



O (HIMEM) 



注） RAM 容量が 32K 以上 
であっても BASIC を 使 
用す る 場合， 32K バイ ト 
しか 使用され ない. 



図 6- 1 Disk-BASIC モードでの メモ リ 状態 

(2) BLOAD 文で， 上で 確保 した メモリ 領域に マシン 語フ アイ ルを 読み込む. 

BLOAD 命令で 読み込む ことので きる マシン 語 ファイル は そのため の 特殊な 形式 を 持つ た 
ものでなくて はなり ませが， これにつ いての 説明 は 5.3 で fi"' います. 

(3) DEF USR 文で， マシン 語 プログラムの 実行 開始 アドレス を 指定す る. 

例えば， D000H 番地から マシン 語 を 読み込んだ 場合 



100 CLEAR ，& HCFFF 
200 BLOAD M MACHIN.BIN W 
300 DEF USR=&HD000 



のように USR 関数 を 設定し ます. これで それ 以降の BASIC プロ グラム 中で 



500 A=USR("c") f マシン 語 ルーチンに，， c" という 1 文字 を 渡し その 結果 を A という' 
、変数に 代入す る ' 
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のように 用いる 事が 出来ます. 

以上が， Disk-BASIC で マシン 語 を 用いる ための 最も 一般的な 方法です が， これ を 実現す 
るた めに は， （2) で 述べた ように， BLOAD 命令で 読み込む ことが 可能な マシン 語 ファイル を 
作らなければ なりません. BLOAD 形式の ファイル は プログラム 部分の 前に， どの 番地から 
ロードす るか， など の 情報が 入 つたへ ッ ダが付 きます. 

以下， 「5.2 C 言語に よる ソース' プログラムの 作成」 では C 言語に よる Disk-BASIC 環 
境の ための プログラム 作成の 実際 を 示し， 「5.3 C 言語 ソース • ファイルから BLOAD ファ 
ィル まで」 では その C 言語の ソースから BLOAD 可能な マシン 語 ファイルの 生成までの コン 
パイル， リンク 等の 手順 を 解説し ます. 



5.S C 言語に よる ソース • プログラムの 作成 



5,5.1 USR 閲 数の 引数の 受取り 方 

USR 関数 呼び出しの 際に 与えられた 引数 は マシン 語 側で は A レジスタで その 型 を 知る ことが 
できます. 下表に A レジスタの 値と 引数の 型 を 示します. 

そして， 実際の 引数の 値 は その実 体が 格納され た アドレスが 渡されます. アドレスが 与えられ 
る レジスタ は 引数の 型に より 異なります. 渡される 引数が 2 バイト 整数 型， 単精度 実数 型， 及び 
倍精度 実数 型の 場合 は HL レジスタに， 文字列 型の 時 は DE レジスタに アドレス が 格納 され ま 
す. （下表参照） 



表 A レジスタに 代入され る 引数の 型 



2 


2 バイ ト 整数 型 


3 


文字列 型 


4 


単精度 実数 型 


8 


倍精度 実数 型 



109 



引数に よる 値の 渡され 方 

2 バイ ト 整数 型 
HL レジスタの 指す ァ ドレス- 



単精度 実数 型 
HL レジスタの 指す アドレス- 



倍精度 実数 型 
HL レジスタの 指す アドレス- 



文字列 型 
DE レジスタの 指す ァ ドレス 



+1 



+ 2 



+ 3 



XX 


XX 


下位 


上位 




+1 


+ 2 


+ 3 


指数 


仮数 


仮数 


仮数 



注 )xx は 

不定です 



+1 +2 



+7 



指数 


仮数 


仮数 




仮数 






+1 


+ 2 





字数 



下位 



上位 



この 3 バイ トをス トリ ング • 
ディスクリプタと 呼ぶ。 



t T 

文字列の 格納され たァ ドレス を 指す 



それで は， このように レジスタに 渡さ れた値 を C の 関数 側で どのよう にしたら 見る こと が 出来 
るで しょうか. ここで， 「3.2.1 パラメータの 渡し 方」 にある 表 を ご覧 下さい. これ を 見る とわ 
かるよう に 固定 パラメ一 タ 関数で は A レジスタの 値 は char 型の 第 1 パラメータ として， DE レ 
ジス タの値 は その他の 型 （2 バイ トの 値） の 第 2 パラメータ として 受け取る 事が 出来ます. HL レ 
ジス タの値 は 第 1 バラ メータ を char 型 以外に 定義 すれば 知る こ とが 出来ます が， そうすると 渡 
された 引数の 型 （A レジスタに 入って いる） を 知る ことができなくなる ので， 結局 C 言語 だけで 
ITSR 関数 を 書く 場合， DE レジスタ により， 文字列 型の 引数 だけが 扱える ことになります' その 
他の 型 を 扱いたい 場合に は， アセンブラで HL レジスタの 値が 得られる ような ィ ン ターフェ一 ス 
ルーチン を 書く 必要が あります. 

以下に C 言語に よる USR 閼 数で 文字列 引数 を 受け取る 場合の メイン ルーチンの 記述 例 を 示し 
ます. 
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Pan 

typedef struct{ 

TINY length; 
char ^strptr; 

} descript; 

«ain(type, desc) 
TINY type; 
DESCRIPT *desc; 
{ 

if(type != 3){ 

outstr(ermes) 
return; 

} 



} 



5,E,2 システム •：! ールの 使い方 

MSX-DOS 上での C 言語 プログラムで ファンクション コール を 使いたい 場合に は， ライ ブラ 
リ 関数の bdos(), bdosh () など を 使う ことが 出来ました. 

Disk-BASIC の 環境 下で も， ファンクション コール （BDOS 機能） が 可能です が， 呼び 先の ァ 
ドレス が MSX- DOS 環境 下での 場合 と 異なる ため 上記の 2 つの 関数 は 使えません. このため， 
BDOS コールに 必要な レジスタ をセッ ト して Disk- BASIC での BDOS コールの 呼び 先ァ ドレス 
を 直接 コールす るよう な プログラム を 書かなくて はなり ません. 

以下に， C 言語の ソース を コンパイルした 結果， どのような アセンブラ 'ソースが 生成され る 
か， という 観点から 解説して いきます. 

ファンクション コール を 実行す るた めに は， CPU の C レジスタに 用いたい 機能の ファン クシ 
ョ ン 番号 を 入れ， その ファンクションで 必要な 引数 を 決められた レジスタに 入れた 後， F37DH 番 
地 （DOS では これが 0005H 番地でした） を コールし ます. 

例 えば， ファンク ショ ン 番号 02H の コンソール 1 文字 出力 ルーチン を 用いて，" a" という で 文字 
を 画面に 表示したい 場合， これ を アセンブラで 記述す ると 

Id e, 'a* 
Id c, 02h 
call 0f370h 



/* type は， A レジス 夕の 値 */ 
/* desc は， D E レジスタ の 値 xl 

/* 引数の 型 は 必ず 文字列 型でなくて 
；/ * はいけ ない ので， type が 3 以外の */ 
A 場合 エラーメッセージで 終了す る */ 



1 1 1 



の 様になります. つまり コンパイルした 結果， 上の ような アセンブラ 'ソースが 生成され るよう 

に プログラム を 書かなければ なりません. つまり， F37DH 番地 を 関数への ポインタ とし， レジス 
タ にセッ ト する 値 を その 関数の 引数と して， 関数 呼び出し をお こなう という ことです. 
実際の 記述 例 を 示します. 

^include <stdio.h> 
ftpragaa nonrec 

puta() /* ファン クシ a ン コールで， a' という 1 文字 を 画面 出力 

{ 

(*(V0ID (*)())(0xf37d))((TINY)0, , a , ,(TINY)0x02); 

} 

1 番目の 引数に 0 を 渡して いますが， これ はフ アン クシ ヨン 02H では 第 1 引数， すなわち A レ 
ジス タ （dummy が char 型 以外なら HL レジスタ） に は 値 をセッ ト する 必要がない のです が， 以 
降の 引数が それぞれ E レジスタ， C レジスタに セットされ るよう にす るた めの， コンパイラに 対 
する 見せかけの 引数です. 上の ソース • ファイル を コンパイルした 結果 は 以下の ようになります. 

； MSX-C ver L20x (code generator) 

cseg 

put ad: 

Id c，2 
Id e,97 
xor a 
call 62333 
ret 

public putae 
end 

A レジスタ を 0 にす る 命令 （xor a) が 余分で ある 以外 は 目的 どおりの アセンブラ' ソース を 
生成す る ことができました. 実際の プログラム では， ファンクション コール を 呼び出す たびに 上 
のように 書く ので はなく #define 文に よって マクロ 定義して おくのが 良いで しょう. 

なお， ファンクション コールの 詳細 は 「MSX-DOS TOOLSj に 付属の マニュアル， 「MSX2 
テクニカル 'ハンドブック」， 「MSX-D0S2 リファレンス マニュアル」 など を ご覧 下さい. 



； ASCII V 
； f37dh in hex 
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5-S,3 儘の 返し 方 

USR 関数の 引数と して 渡された 文字列の 内容 を 書き換える ことによって， USR 関数の 値 を 
BASIC に 引き渡す ことができます. 但し， 文字 数 を 変える こと はでき ません. 6.2.1 の 例での 値 
の 文字列の 返 し 方の 例 を 下に 示 します. 



例 



retbas(deso.newstr; 
DESCRIP xdesc; 
char *newstr; 
{ 

if (strlen(str) != (intjdesc->length){ 
outstr(erames4); 
return; 

} 

desc->strptr = newstr; /* 新しい 文字列 をセ ッ ト して */ 

return; 戻り 値な しの リターン */ 

} 

上記の 例の ように 渡された 文字列への ボイ ンタ を， 返したい 文字列への ポィ ンタに 変えて しま 
つても よい わけです. 
値 を 受け取る 側の BASIC の 記述 例 を 下に 示します. 

1000 B$=USR(A$) 



5.3 C 言語 ソース • ファイルから BLOAD ファイルまで 



5,3, 1 L80 た mi よる BLOAD ファイルの 作成 

C 言語の ソース • ファイルが 書け たら， コンパイル， リンクに より BLOAD 形式の オブジェ ク 
ト ファイル を 作ります. CF， FPC, CG 及び MSX-M- 80 を 使って リ ロケータ ブル. ファイル （. 
rel) を 作る ところまで は DOS の コマンド .フ アイ ルの 作成 と 同様です が， リンク のし かたが 異な 
ります. 

ここで MSX- DOS の コマンド 'ファイル （, com ) が 100H 番地から 口 一 ド 実行され る こ と を 思 
いだして 下さい (詳細 は MSX-DOS の マニュアル 等 参照の こと）. MSX'L- 80 でリ ンク する 場合 
ロード 開始 アドレス を 特に 指定 しないと， 100H 番地からの 才ブ ジヱク トが 作られる のです です 
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から DOS 上の コマ ン ド • ファイル を 作る 場合に は ロード 開始 ァ ド レス と いった こと を 特に 意識 
しないでも 良かった わけです. ヒ ころが, Disk-BASIC での ルーチンの 場合に は， 5.1 Disk- 
BASIC 環境での マシン 語 ルーチンの 作成 A) および B) で 述べた ように， ユーザー • エリアの ど 
こ に マシン 語 を 置 く か は ユーザー 自身が 決めな く て はな り ません. その ェ リ ァの 開始 ァ ド レス か 
ら ロード 開始され るよう なォ ブジェク トを 生成す るた めに は， リ ンク 時に L80 の/ p オプション を 
用います， D000H 番地からの 場合 以下の ようになる でしよう. 

A>180 /p:dOOO,usrfunc,usrfunc/n/e:start 

但し， こうして 出来上がった ファイル は 相変わらず DOS の コマンド 形式の ファイル （.com) 
です. すなわち 103H 番地から CFFFH 番地までに 相当す ると ころ は 不要な データ （ゴ ミ？） で 
うまって いるので す. ひ00- 102H に は" start ： "への ジャンプ 命令が 入って いる） したがって Disk 
-BASIC で この ファイル を D0OOH 番地 か ら ロードす るのに BLOAD 命令 は 用いる ことができ ま 
せん. ゴミ データ の 部分 を 1 ノく イト ずつ 読み と ばし， 必要な ところ だけ を D000H 番地 か らの エリ 
ァに 格納す るよう な プログラム を 書かなければ なりません. しかし， 一旦 このように 読み込む こ 
とがで きれば， Disk-BASIC の BSAVE 命令に より D000H 番地から を セーブし ておけば 次回 か 
らは BLOAD 命令で ロードで きる ファイル （BLOAD ファイル） として ディスクに 記録され ま 
す. 

5,3,2 MSX-DOSg TOOLS の BSAVE コ マン 使う 

MSX-DOS2 TOOLS に 付属の BSAVE コマンド を 用いる ことで， 5.3.1 で 述べた ような 作業な 
しに， .rel フ アイ ルか ら BLOAD 形式め フ アイ ルを 簡単に 作る こ と がで きます. 
以下に その 手順 を 述べます. 

まず， リンク 時に /x オプションで .hex ファイル をつ く ります- 

A> 180 /p: dOOO , usrfunc , usrfunc/n/ x/e:startQ£) 

これで D0O0H 番地から 実行可能な usrfunc.hex という ファイルが 作られます. この ファイル を 
MSX-DOS2 TOOLS の BSAVE (Disk-BASIC の BSAVE 命令に ではない） コマンド に 入力す 
る ことにより Disk-BASIC で BLOAD 可能な フ アイ ルに 簡単に 変換す る ことができ ま す. 

A>bsave usrfunc. hex >uspfunc.binQ£) 

とする ことにより 生成され る ファイル usrfunc.bin は Disk-BASIC の BLOAD 命令で 読み込む 
こ と がで きる 形式 を もつ フ アイ ル です. 
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5.4 サンプル • プログラムに ついて 

本パ ッ ケージの ディスクに は Disk-BASIC 下の マ シ ン語 ルーチンの サンプル として， search.c, 
search.bas, search.bat, bk,mac の 4 つの フ アイ ルが 含まれて います. 

search.c は， システム コール を 用いて ディスク 上の ファイル を 検索す る C 言語の ルーチン であ 
り search.bas の サブルーチン として 用いられます. 

search.bat は， search.c を コンパイル， アセンブルした 後， bk.mac を アセンブルした bk.rel と 
ともに リンクし search.hex を 生成 します. 

次に， MSX-D0S2 TOOLS の BSAVE コマンド を 実行し BLOAD 形式の ファイルに 変換し ま 
す. さらに Disk-BASIC を 起動し， search,bas を 口一 ド 実行まで 行い ま す. こ のバ ッ チ 処理 を 起 
動す る だけで Disk- BASIC 用の マシン 語 サブルーチンの 作成 過程 を 追う ことができます. 

I 注意 I search.bat を 最後まで 実行す る に は TOOLS の BSAVE コマンドが カレント ドライブの 
カレント ディ レク ト リに 必要です. 

以上で， Disk-BASIC 環境での マシン 語 ルーチンの 作成 手順 を 大まかに 述べて きました. 引数 
の 扱い方 や BLOAD 形式の ファイル 作成の 部分で 説明 を 省いた 点 もあります が， 不明な 点 は 
r MSX2 テクニカル ハンドブック」， 「MSX-D0S2T00LS」 マニュアル 等 や， MSX-BASIC に 
関する 文献 を あたって 下さい. 



5.5 ROM 化 プログラムの 作成 

ここで は， ROM に プログラム を 書き込む ための 手順と 方法に ついて 説明し ます. 



5,5,1 ROM 化 プログラム 作成の， 



A) ラれ ラリの 引用に ついて 

ROM 化 プログラム を 作成す るに あたって， 最初に 問題と なる の は， 標準 カーネル （CK) およ 
び 標準 ライブラリ （CLIB) です. これらの プログラムの 中には， MSX-DOS の 機能 を 使って いる 
ものが あるので， ROM 化 プログラムの 開発で は 使う こと はでき ません. ただし， CLIB の 中には 
strcpy ( ) や toupper () など MSX-DOS に 依存し ない 関数 も 含まれて います. これらに ついて 
は， ROM 化 プログラム でも 使用可能 なのです が， 安易に CLIB をリ ンク してし まう と， BDOS 機 
能 を 使って いる 関数 を 誤って 呼んで しまう 恐れが あります. 
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したがって， これらの 関数 （strcpy () や toupper ()) を 使用した いとき は， 

(1) 作成して いる プログラム 中に 関数 を ソース プログラム のままで 取り込む 
あるいは， 

(2) clib.rel の 中から LIB80 (ライブラリ マネ ジャ） を 用いて ROM 化 可能な 関数 だけ を 抜き出 
し， 別に ライブラリ を 作る 

の， どちら かの 方法 をと つて 下さい. 

また， ヘッダ ファイル も そのまま では 使えません. 必要な 部分 だけ を 抜き出して， 別の ヘッダ 
ファイル を 作って 下さい. 



B) 初期 B 定の 節分 

次に， 初期化の 処理 を ROM 化 プログラムで 行う 必要が あります. MSX- DOS 下で 動く プロ グ 
ラムの 場合 は， 初期設定 は clib.rel 中の カーネル 本体で 行なって いる わけです が， 前述の よう に 力 
—ネル は ROM 化 プログラム では 使用 不可能で すので， これに 代わる も のが 必要 となります. 

通常， 初期設定 は 次の ような アセンブラ 'プログラムで 行ないます. 

extrn nainO 

Id sp, スタックの アドレス 
(必^ならば ハー ドウ ユアの 初期設定 を 行う） 

jp laino 

end 

すなわち， スタックポインタ を 設定し， 必要な ハードウェアの 初期設定 を 行なった のちに C の 
関数 main () へ ジャンプ する わけです （このと き， C の 入口の 名前が main でなければ いけない と 
いう 制限 はなく， たとえば foo でも zot でも かまわない）. この場合に は， main() に 渡す パラメ 
ータ はありません ので， 通常の MSX-DOS における main () プログラムと は 異なり， 

VOID nainO 
{ 

} 
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第 5 章 MSX-C コンパイラの 応用 



と 書かなくて はなり ません. 

さて， 上の 初期設定 プログラムの 使い方で すが， まず この プログラム を 作り， アセンブルして， 
.rel ファイル にして おき， リ ンク するとき に 先頭に つけて 下さい. 5.5.2 で 実際の 例 を 示します. 



OIN/OUT 

'ROM 化する ときに 最も 悩む のが IN/OUT です. アセンブラ では IN, OUT 命令 を 使用 すれ 
ばよ いのです が， C 言語で は そのような 命令 は 用意され ていません ので， 関数と して 呼び出す こと 
になります. 

MSX - C の 標準 ライ ブラ リの 中には， inp () と outp () という 関数が 含まれて おり， これら を 用 
いるの が 最も 簡単な 方法でしょう. 

第 2 の やり方 は， ひとつの ポートから IN/OUT を 行な う 関数 を 各ポ一 卜 ご と に 用意す ると い 
う ものです. たとえば， 



publio indato, inotio, outdato, outctlo 

indato: 

in a ( (00h) 
ret 

inctio: 

in a,(01h) 
ret 

outdato: 

out (OOh), a 
ret 

outctlo 二 

out (Olh), a 
ret 



と 4 つの 関数 を アセンブラで 作って おき， C の プログラムで 



char indatO, inctlO; 
VOID outdatO, outctlO; 

VOID initO 
{ 

outctK(char)OxOl); 
outctl((char)0x01); 
outctl((char)0x40); 
outct 1 ((char)Oxce) ； 
outctl((char)0x37); 

} 

char getch() 
{ 

while ((i net I() & 0x02) == 0) 
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return (indatO); 

} 

VOID putch(c) 
char c; 
( 

vhile ((inctlO & 0x01) == 0) 
outdat(c); 

} 

というよ うに 呼び出して 使います. （この プログラム は， 8251 の 初期設定 （init ())， 入力 （getch 
( ))， 出力 （putch ( ) ) を 行な う） この やり方なら ば， アセンブラで INZOUT を 行なった 場合に く 
ら ベて CALL/RET が 余分に 実行され る だけです から， inp ( ) や outp ( ) ほ ど 遅 く は あ り ません. 

D) 絶対 番地の き 照 

入出力 ポートが I/O 空間で なく， メモリ 空間に 割り当てられ ている 場合が あります. この場合 

の 入出力 操作 は， I/O のとき よりもぐ つと スマート に 記述で きます. 

た とえば， 先 ほ どの プロ グラムで ポー ト 00H の 代わ り に 0FF0OH, 01H の 代わ り に 0FF01H を 
使って 操作 を 行なう とすると， 次のように 書け ます. 

tdefine dataport (*(char *)0xff00) 
define Ctrl port (*(char *)0xff01) 

char getchO 
{ 

while ((ctrlport & 0x02) == 0) 
return (dataport); 

} 

VOID putch(c) 
char c; 
{ 

while ((ctrlport & 0x01) == 0) 
dataport = c; 

} 

VOID InitO 
{ 

ctrlport = 0x01； 
ctrlport = 0x01； 
ctrlport = 0x40； 
ctrlport = Oxce; 
ctrlport = 0x37； 

} 
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第 5 草 MSX-C コンパイラの 応用 



E) 割り込み 題 

MSX-C では， 割り込み 処理 も 行なう ことができます. ただし， いくつかの 言語 プロセッサで 導 
入され ている ような， 「割り込み 手続き 宣言」 は 用意され ていません. したがって コンパイラ は， 
割り込みの 入口での 全 レジスタの 待避， 出口での レジスタの 回復， そして 割り込み マスクの 解除 
といった シーケンス は 生成し ません ので， こういった 処理 は アセンブラで 書いて やらなくて はな 
らな いのです. 

例と して， 1 秒 ごとに タイマ 割り込みが 入って， 時刻 データ を 更新 するとい う プログラム を 考え 
てみ ましょう. 時刻 は， それぞれ TINY 型の hour, minute, second で 表す ことにし， 割り込み 
は 0038H に 入って く る ものと します. 



アセンブラ ： 

extrn crst70 
aseg 

org 0038h 
jp rst7 

rst7: 

af 
be 
de 
hi 

crst7 き 
hi 
de 

pop be 
pop af 
ei 
ret 



TINY hour, iinute» second; 

VOID crst7() 
{ 

if (++second >= 60) { 
second = 0； 
if (++ 鼴 inute >= 60) { 
ninute = 0； 
if(++hour >= 24) 
hour - 0； 

} 

} 

} 



h h h h I 

s s s s 1 p p 

u u u u A» o o 

p p p p c p p 
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C の プログラム 中で， 割り込み を 禁止したり， 解除したり という 処理が 必要な 場合 は， ァ セン ブ 

ラで， 

public diQ» eiO 

dio: 

di ； 割り込み 禁止 

ret 

ei©: 

ei ； 割り込み 許可 

ret 

という 関数 を 作つ て 呼んで 下さ い. 

割り込み について 注意し なければ ならない 点が あります. それ は， 割り込み 処理と 通常の 処理 
の 両方から 呼ばれる 関数が ある 場合， その 関数 は recursive (再帰 呼び出し 可能） にして お く 必要 
が あると いう ことです ♦ このような場合に は， 実際に 再帰 呼び出し はして いなく とも， recursive 
にして 下さい， 



F) 定数 トブル (Dffl い 

イニシャル ライ ズ されて いる 変数の う ち， 記憶 ク ラスが static と extern の もの は コード' セグ 
メント （CSEG) に 配置され ます. MSX-DOS 環境 下の ように RAM 上で プログラム を 動かす 場 
合に は， これらの 変数の 値 を 変更す る ことができ ますが， その プログラム を ROM に 書き込んだ 
場合に は， これらの 変数 は コード • セグメントに 置かれる ので 値 を 書き換える ことができ なくな 
り， あたかも 「定数」 であるかの ような 振舞い をし ます. したがって， 変数の 記憶 クラス や プロ 
グラム 中での 実際の 使用に ついては 十分に 注意して 下さい. 

ROM 化 プログラム における 初期化 プログラムの 役割 は 「定数 テーブル を 実現す る」 ことで あ 
り， 変数 を 初期化す る ことではありません. 変数 を 初期化す る 場合に は， 代入 文で 行なう 必要が 
あります. また， 文字列 は 「言 己 憶 クラス static である 初期化 された 文字の 配列」 であり コード • 
セグメント に 配置され るた めに， ROM に 書き込んだ 場合に は その 値 を 変える こ と はでき ません. 

5,5,6 ROM 化 プログラムの 作成 例 

MSX-C コンパイラ 'パッケージに は， romO . mac および roml . c という フ アイ ルが入 つてい ま 
す. これ は， ROM 化 用の サンプル プログラム であり， MSX で 実際に ROM に 焼いて 動作させる 
こ とがで きます. 

まず romO.mac を 以下の ように アセンブルし， .rel ファイル を 作成して 下さい. 
A>b80 =ronO(>J 
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第 5：^ MSX-C コンパイラの fcffl 



次に， roml.c を コンパイルして. rel ファイル を 作成して 下さい. 以下の シーケンス でで きま 



del rooil 屬 c 

最後に リンクし ます. これ は 次の コマンドで できます. 

180 /p:0,/d:RAM の 先頭 ァ ドレス， roroO,roiBl,cnm/s,roB/n/e 

Origin below loader memory, move anyway (YorN)?N (必ず N と 答える） 

以上の リンクが 終る と， rom.com がで きています. これ を ROM に 書き込んで 下さい. 

この プログラム を 実行す ると， "> "という プロンプトが 表示され ます， ここで 

>dO,FF 

と 入力す ると， 0 番地から 00FFH 番地までの 内容が ダンプ されます. また， 



と 入力す ると メモリの 内容が 表示され， 新しい 値 を 書き込む ことができます. 

この プログラム は D と S コマンド しかない デバッガです. プログラミングの 練習と して， この 
プログラム を 拡張して， より 高機能な デバッガ を 作成して みて ください. 



cf roml 
fpc -u roml 
eg ro 画 1 
udO =rowl 



(ron し nac の アセンブル） 



>sxxxx 
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第 B 章 標準 ラ<7 ラリ 関数 リファレンス 

この 章で は MSX-C Ver. 1.2 の 標準 ライ ブラ リ 関数 を アルファべ ッ ト 順に 解説して いきます. 
関数の リファレンス マニュアル として ご 使用 下さい. 

ひとつの 関数 は 次の ような 7 項目から 成り立ちます. これらの 項目 は 必要がない 場合に は 省略 
される ことがあります. 

(1) 1 関数 名 ~ 1 

解説す る 関数の 関数 名 だけ を 示します. 関数 getchar () の 場合 は， "getchar" を 示します. ま 
た， 同 ページ 内で 複数の 関数 を 解説す る ときには， それら を 続けて 書きます. 

(2) | 書 式 ， (関数の ヘッダ） 

関数 を 使用す る 際の 書式と して 関数の ヘッダ を 示します. また， 関数に 必要な ヘッダ フ アイ 
ルも 示します. この ヘッダ ファイル は stdio.h を 単純に ィ ン クルー ド している 場合に はィ ン 
ク ルードす る 必要はありません， この 詳細に ついては 「4.2 ヘッダ ファイル」 を ご覧 下さ 
い. 

(3) | 解脱， 

関数が どのような 動作 をす るか を 解説し ます. また， 関数に パラメータが あれば その 説明 も 
含めて します. 

(4) 1 戻り 値 ~ | 

関数の 動作の 結果， どのような 値が 返される か を 解説し ます. 

(5) i 参照" n 

解説して いる 関数と 対 するべき 他の 関数 を 示します. 

(6) 1 洤意， 

関数 を 使用す るに 当たって 注意し なければ ならない こと を 示します * 

(7) 1 例 "1 

関数 を 使った 簡単な 例 を 示します. この 例 は コンパイル すれば コマンドになる ように 記述 さ 
れ ています. 

項目 は 以上です が， 動作が 不明の ときには ライブラリ ソースファイル を ご覧に なること をお 勧 
めします. 
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第 6 章 標準 ライブラリ Kj 数 リファレンス 



abs 



I 害 式 t 

# include <stdlib.h> 

int abs^n) 
int n ； 



r 解脱 i 

整数 n の 絶対値 を 与えます. 絶対値と は， あれば その 数の 負号 (一） をと つた 値 をい います. 0 の 
絶対値 は 0， 5 の 絶対値 は 5， -3 の 絶対値 は 3 のようになります. 



戻り 值 1 

整数 n の 絶対値 を 返します. つまり， n が 0 または 正の 時 は n を 返し， n が 負で あれば- n を 返 
します. 



注 意 I 

abs( ) では 整数の 負の 最大値 (-32768) の 変換が できません (同じ 値：^ 返って きます). 



例 I 
Hinclude <stdio.h> 

/t -3, 0， 5 の 絶対値 を 表示し ます xl 

■ain() 

{ 

printf( w Xd %d Xd¥n w , abs(-3). abs(0). abs(5»; 

} 
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alloc 



i 害 式 i 

# include <malloc,h> 

char *alloc(n) 
size t n ； 



[ 解 _ 脱 _ I 

free( ) によつ て 解放 可能な メモリ 領域 を n バイト 確保し ま す. all oc ( ) と f ree ( ) は 高水準 メ モ 
リ 管理 関数で， 組合せて 使用され ます. alloc() は 実行時に その 状況に 応じて 領域が 必要な ときに 
使い， free() は その 領域が 不要に なった ときに 使います. 詳しく は 「4. 3. 3 メモリ 管理 関数」 を 
参照して 下さい. 

I 戻り 値 | 

割り当てられた 領域の 先頭への ポインタが 返されます. 十分な メモリが なレ 、場合 に は NULL 
が 返されます. 

I 参照 I 

free( ), rsvstk()， sbrk( ) 

1 注意 I 

戻り 値 は 使用で きる 領域の 先頭 アドレス ですから それ を p とすれば， p から （p + n-】） までが， ュ 
—ザ一 は 自由に 使う ことができます. 

free() で 解放され た 領域で 11 バイ ト 以上の 領域がない 場合に は sbrk( ) で 領域 を 確保し ようと 
します， つまり n バイト alloc() し， 直後に そこ を free() してから， （n+m) バイト alloc( ) しょ 
うとす ると （(n+sizeof(HEADER)) + (n+m+sizeof (HEADER))) 以上の メモリが 必要に な 
ります. 



124 



第 標準 ライブラリ M 数 リファレンス 



厂 例 1 

^include <stdio.h> 
1% 

バッファ サイ ズを 指定して フ ァ ィ ルハ ン ドル src から dst に 

ファイル コピー をす る閼 数です 

*/ 

cp(dst, src, bufsiz) /* copy src to dst with buffer */ 
dst, src; /* file handles */ 

bufs!2; /* specify buffer size */ 



STATUS 
FD 

size 
{ 



char *buf ； 
int datsiz; 

if ((buf = elloo(bufsiz)) == NULL) /* get temporary buffer */ 
return (ERROR); /* not enough neaory */ 

while (datsiz = read(sro t buf, bufsiz)) 
if (write(dst, buf, datsiz) 0) 
return (ERROR); 

free(buf); /% free temporary buffer */ 

return (OK); 



覼 ain(Brgc, argv) 
int argc; 

*argv[]; 



char 
{ 



FD s, d; 
argc— ； 

if (argc < 2) { 

puts( M Usage: cp <src> <dst>¥n w ); 
^ exit(l); 

s = openCargvCl], 0.RD0NLY); 
d 二 



if (s == ERROR II d == ERROR) { 

puts( w File cannot open¥n"); 
exit(l); 

} 

if (cp(s, d, 2048) == ERROR) { 

puts ぐ， File copy failed¥n w ); 
) exit(l); 

close(s); 
close(d); 
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atoi 



厂害式 i 

# include <stdlib.h> 

int atoi(s) 
char *s ； 



解 脱 



文字列 を 符号つ き 10 進数の 整数 値に 変換し ます. 先頭の スペース， タブ は 無視され， 次に 符号 
(+ か—） が 入れられます. 10 進数 以外の 文字まで を 数値と して 変換し ます, 整数の 範囲 （-32768 か 
ら 32767 ま で） を 越えた と き， 桁 あふれ は 無視され て しまいます. 



戻り 値 



文字列 を 変換 し た 整数 値 を 返 します. 



# 照 



fscanfO, scanfO, sscanf( ) の" ％d "での 変換 



注 意 



入力 文字列が 整数の 範囲 を 越えて いる 時に， 桁 あふれ を 起こしても エラーが 発生し ません. 



例 



^include <stdio.h> 
1% 

文字列 定数" -232", 文字列" 732" を 数値に してから 表示と 
キーボードからの 入力 を 数値に して 変数に 代入し， 表示す る 
*/ 

static 
char 



nainO 
{ 



char intstrL] 
buf[63; 



"732"; 



int 



i; 



printf("Xd Xd*n M . atoi (，し 232"), atoi(intstr)); 
gets(buf, 6)； 
i = atoi(buf); 
printfCXd¥n w , i); 
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第 6 章 標準 ライブラリ 関数 リファレンス 



bdos, bdosh 



i 書式 i 

include <bdosfunc.h> 

char bdos(c[, de, hi]) 

char c ； 

int bdosh (c[, de, hi]) 

char c ； 



I 解 —説 」 

MSX-DOS の ファンク ショ ン コール を 呼び出します. 第 1 パラメータに ファンクション コール 
名 を 指定 します. ファンクション コール 名 は ヘッダ ファイル bdosfunc.h で # define されて いま 
す. 第 2， 第 3 パラメータ は 必要ない とき は 設定し なくて 構いません. 指定され たと き は それぞれ 
de, hi レジスタに 渡され， ファンクション コール を 呼び出します. 



厂 戻り 値 | 

bdos() の 場合 は ファンクション コール 終了 時の a レジスタの 値 を char 型で 返します. bdosh 
() は ファンクション コ ール 終了 時の hi レジスタ の 値 を int 型で 返 します. 



「参照 1 

call()， calla( ), callxx( ) 

I 注意 I 

第 1 パラメータ は， ファンクション コール 名 （または 番号） を 指定し ますが， 必ず char 型 か 
TINY 型で 指定して 下さい. 指定して いない 場合 は ファンクション コール 名が 正しく MSX-DOS 
に 渡り ません. 

MSX-C Ver. 1.1 までの bdosfunch と は ファンクション コール 名が 変わって いますので， そ 
れを 使って いる 場合 は 変更が 必要です. ファンクション コール 名 は MSX-D0S2 の ファンク ショ 
ン 仕様書に ある ラベル 名と 同 じに なって います. 
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I 例 I 

^include <stdio.h> 
# include <bdosfuno.h> 

/* つながつ ている ドライブ を 表示す る */ 

nainO 

{ 

TINY i， login; 

login = (TINY)bdosh(.LOGlN); 
for (i = 0； i < 8； i++) { 

if (login & 1) 

printf ("drive Xc is active¥n", ，A' + i); 

login »= 1; 

} 

) 
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第 6 章 標準 ライブラリ 閣数 リファレンス 



bios 



厂睿式 I 

# include <bdosfunc.h> 

char bios(code) 
char code ； 



解 脱 I 

MSX-DOS の BIOS コール をす る, 



厂 戾り懷 I 

BIOS コ 一 ル 後の a レジスタの 値 を char 型に して 返します. 

I 例 I 

itinclude <stdio.h> 
itinclude <bdosfunc.h> 

■ainO 

{ 

char c; 

c = getchO; 
Mos し CONOUT, c); 
bios(BI0S„C0N0UT, c); 

} 
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callt calla 



害 式 i 

int call(addr, a, hi, be, de) 
int *addr, a, hi, be, de ； 



char calla(addr T a, hi, be, de) 
int *addr, a, hi, be, de ； 



厂 解脱 1 

レジスタ を 指定して 特定 番地 を 呼び出します. アセンブラで 記述して ある サブルーチン 等 を 使 
用す る 場合に 利用し ます. 

1 戻り 値 I 

call( ) は addr で 示される ルーチン 終了 時の hi レジスタの 値 を int 型に して 返します. calla ( ) 
は addr で 示される ルー チ ン 終了 時の a レジスタの 値 を 返します. 

I 注窻 I 

ix， iy と 裏 レジスタ は 設定で き ません. ix, iy を 指定す る 場合 は calbcx( ) をお 使い 下さい， 

1 例 I 

^include <stdio.h> 
#include <bdosfunc.h> 
#def ine dunny 0 

雇 &iiK&rgc, argv) 
int argc; 
char 家 &rgv(!L 
{ 

FD fd; 

if (-- argc < 2) { 

puts ぐ， Usage: hrename <pathnane> <basename>¥n M ); 
exit(l); 

} 

if ((fd - open(argv[l], OJDONLY)) == ERROR) { 
puts ぐ , File not open¥n")l 
exit(l); 

} 

ン クシ ヨン コール' ファイル ハンドルの 名前の 変更' を 実行す る */ 
if (ca!la(BD0S t durany, argv[2], fd * 256 + .HRENAME, dummy)) { 
puts( M Handle rename failed¥n M ); 
exit(l); 

} 



/* プア 



} 
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第 6 章 標準 ライブラリ^ 数 リファレンス 



callxx 



[書式 1 

ff include <bdosfunc.h> 

VOID callxx(adrs， reg) 
unsigned adrs ； 
XREG *reg ； 

I 解脱 I 

レジスタ を 設定して adrs で 示される ルーチン を 呼び出します. 設定で きる レジスタ は af, ix， 
iy， be, de, hi です. レジスタ は XREG 型の 構造体に 代入して お きます. callxx( ) 実行 後 は XREG 
型の 構造体に は 呼び出された ルーチンから 返って きた 各 レジスタの 値が 入って います. この 関数 
は 必要な 値 を MSX- DOS の ファンク ショ ン コールに 渡したり， ファンクション コールからの 値 
を 受け取る のに 利用し ます. XREG 型 は bdosfunc.h の 中に 定義され ています. 



戻り 値 | 

あり ません. 



參 照 | 

bdosO, bdoshO, callO, calla( ) 

注 意 I 

この 関数 は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した， 



_m ] 

^include <stdio.h> 
^Include <bdosfunc.h> 

tainO 

{ 

XREG reg; 
/* DOS の パージ er ンを 表示す る */ 
reg.be = (unsigned).DOSVER; 
callxx(BDOS, &reg); 

printf( w MSX-DOS Version Xx,X02xW, reg.be I 266. reg.be % 256)； 
printf( w MSXD0S2.SYS Version Xx.%02x¥n" ( reg.de I 256, reg.de % 256)； 
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chdir 



r~m 式 1 

# include <direct.h> 

STATUS chdir(path) 
char *path ； 



厂 解説 1 

カレント ディレクトリ を 変更し ます. path は ディ レクト リ名を 指定し ます. ルート ディ レクト 
リ からの 指定で も， カレント ディ レクト リ からの 指定で もで きます. ドライブ を path 中に 指定す 
ると その ドライブの カレント ディ レク ト リが 変更され ます. （ぉ：][¥]ロ&«1の形で指定します.） 

1 戻り 値 I 

カレント ディレクトリ が 変更され た 場合に は 0K を， 失敗 し た 場合に は ERROR を 返します. 



參 照 1 

getcwd()， mkdir()， rmdiu ) 

注 意 I 

chdir( ) では カレント ドライブの 変更 はでき ません. 

この 関数 は Ver. 1.2 から 標準 ライ ブラ リ に 追加され ました. 



_m ] 

# include <stdio.h> 
重 ainO 

/* ルート ディ レクト リに bin という ディ レク ト リが あるか を 調べる */ 
if (chdir ひ ¥¥bin") == ERROR) 

puts( w There is no ，¥¥bin， Subdirectory. ¥n"); 
chdir ("科"）； 

) 
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標^ ライブラリ 関数 リファレンス 



clearerr 



I 害 式 I 

# include <stdio.h> 



VOID clearerr (fp) 
FILE *fp ； 



厂 解脱 1 

fp で 示された ファイルの エラー 状態 を 解除し ます. clearerr() は 標準入力から 入力して， 一度 
エンド ォブ ファイル (EOF) となつ た 後， も う 一度 入力す る 場合に clearerr ( ) で エンド ォブフ アイ 
ル (EOF) の フラグ をク リアし， 読み込める 状態に する のによ く 使われる 関数です . 



戾り傕 I 

戻り 値はありません， 



厂 注意 I 

この 関数 は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した, 



_W ] 

^include <stdio.h> 

朧 ainO 
{ 

int c; 

標準入力が エンド ォブ ファイル fc なった 後， 再度 入力す る */ 
while ((c = getcharO) 1= EOF) 

putchar((char)c;; 
if (getcharO == EOF) 

puts( w now E0F¥n"); 

else 

Puts( w not EOHfn"); 
clearerr(stdin); 
while ((c = getcharO) != EOF) 

putchar((char)c); 

} 
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close 



i 害 式 i 

# include <io.h> 

STATUS close(fd) 
FD fd ； 

厂 解説 I 

ファイル ハンドル f d で 示 される ファイル を クローズ します. 
I 戻り 傕 I 

フ アイ ルハ ン ドルの クロー ズが 成功 すれば 0K を 返します. そうでな ければ ERROR を 返し ま 
す. 

I 注意 I 

close( ) は 低水準 入出力 関数です. 



例 I 
#inciude <stdio.h> 

static char nsg[] = "write open and close つ 

nainO 

{ 

FD fd; 

/* ファイルに データ を 書いて， クローズして 終了す る %1 
if ((fd = open("data", 0— 画 LY)) -= ERROR) { 
puts( w File cannot nake¥n M ); 
exit(i); 

) 

write(fd, nsg f strlen(nsg)" 
close(fd); 

} 
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第 6 章 標职 ライブラリ IS) 数 リファレンス 



creai 



厂 書式， 

# include <io.h> 

FD creat(filename) 
char * filename ； 



厂 解脱 I 

filename で 示された フ アイ ルを 作成 します. フ アイ ルの 作成 とはフ アイ ル がすで に あるとき 
は， その ファイルの 内容 を 消去して から オープン します * 



戻り 値 1 

ディスク エラ一 などで ファイルが オープンで きないと き は ERROR を 返します. そうでな いと 
き はフ ァ ィ ルハン ドル を 返します. 



參 照 1 

close ( ), opem)， read( ), write リ 

注 意 I 

creat( ) は 低水準 入出力 関数です. 



_m ] 

^include <stdio.h> 

static char str[] = "test data"; 

nainO 

{ 

FD fd; 

/* ファイル を 新規に 作成して， データ を 寄いて， クローズして 終る */ 
if ((fd = creat( M creat.dat w )) == ERROR) i 
puts ぐ , File cannot creat^n"); 
exit(l); 

} 

write(fd, str, strlen(str)); 
close(fd); 

) 



135 



eof 



i 害 式 i 

# include<io.h> 

BOOL eof(fd) 
FD fd ； 

I 解脱 I 

ファイル ハンドル fd が， ファイルの 終わり （エンド ォブ ファイル， EOF) まで 読み込んだ かどう 
か を 調べます. この 関数 は 標準入力が リ ダイレク 卜されて いて， getch() で 文字 を 取り込み たいと 
きに あらかじめ EOF かどう か を 調べる ことで， 標準入力の EOF エラーで コマンドが 終了して し 
まう こと を 避ける ことができます. 

厂 戻り 値 1 

ファイル ハンドルが EOF であるか， ファイルが オープンされ ていないと TRUE を 返します. 
そ う でな ければ FALSE を 返し ま す. 



「参照 I 

feof ( ) 

I 注意 I 

この eof () は 低水準 入出力 関数に 対応す る EOF を 調べる 関数です. 高水準 入出力 関数で ァク 
セス した ファイル ハンドル に対して 行っても， 正しい 値 を 返しません. 高水準 入出力 関数に 関し 
て は feof () を 使用して 下さい. 

こ の 関数 は Ver . 1 .2 から 標準 ラ ィ ブラ リ に 追加され ま した. 



_m 

Itinclude <stdio.h> 
char but [100]； 

nainO 
{ 

FD fd; 

/* ファイル も 100 バイ トずゥ エンド ォブ ファイルまで 読む */ 

fd open( M file , \ 0.RD0NLY); /* 存在す る ファイル を 指定す る */ 
while (read(fd, buf, 100)) { 

PUts(eof(fd) ？ ，'TURE¥n" ： "FALSE¥n"); 

} 

puts(eof(fd) ？ "T 画 n" ： "FALSER"); 
close(fd); 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



execl, execlp 



厂害式 i 

# include < process.h > 

VOID execl(progname, argl , arg2, ...) 
char * progname, *arg1 , *arg2, ... ； 

VOID execlp (progname, argl , arg2, ...) 
char * progname, *arg1 , *arg2, … ； 



「解脱 I 

execK ), execlp( ) は どちらも 別の プログラム フ アイ ルを 読み込み， それ を 実行し ます. 文字列 
progname に は， 実行すべき ファイル 名 を 与えます. ファイル 名が 拡張 子 を 持たない 場合に は，， 
com が 仮定され ま す. progname で 指定した ファイルがない 場合に， execl( ) は 
"cannot exec ： く progname> "と 標準 エラー 出力に 出力して 関数から 戻って きます. しかし， 
execlpO は 環境 変数 PATH の 示す ディ レク トリから 探します. それでも 見つからな いと execlp 
0 は" cannot exec ： く progname> "と 標準 エラ一 出力に 出力して 関数から 戻って きます， 

argl, arg2, …で 指定され る 文字列が コマンド 引数と して チヱ インされ る プログラムに 渡され 
ます. 

現在 才 一プン されて いる 低水準 入出力 ファイル は オープン された まま 指定の コマンド が 実行 さ 
れ ます. 

execK w ti 隨 e", "is", "noney."); 

これ は コマンド 行で 

A>tiie is 矚 oney.0 

と コマンド を 与える のと 同じ 効果 を 持ちます， 

I 戻り 値 I 

ありません. 

I 参照 I 

execv( )， execvp( ) 
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「注意 1 

execl ( ) , execlp( ) は 可変 パラ メータ 関数な ので 
VOID execl(.), execlp(.); 

という 宣言が あ ら かじ め 必要です. こ の 宣言 は ヘッダ フ アイ ル process.h に 含まれて います. 
execl ( ) は， プログラムが 見つからない ときの 動作が 変更され ま した. 
execlp( ) は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した. 

execip( ) は progname に ドライブ 名 や ルート ディ レク ト リ からの 指定が ある と， ファイル を 環 
境 変数 PATH の 示す ディ レクト リ から 見つける ことができません. 



_M | 

^include <stdio*h> 
/* 

コ マン ドの パラメータが 1 から 3 個の 時， パラメータ を 逆 照に し， 

最後の パラメータ を コマンド として 起動 

*/ 

Bain(argc, argv) 
int argc; 
char *apgvu; 
{ 

switch (argc) { 
case 1 ' 

execlp(ergvCl]); 
case 2： 

execlp(argv[2], argv[l])i 
case 3： 

execlp(argv[3], argv[2], argv[l]); 

} 

} 
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第 6 章 標準 ライブラリ 1^1 数 リファレンス 

execvt execvp 



厂 書式 i 

# include <process.h> 

VOID execv(progname, argv) 
char *progname, * argv 口 ； 

VOID execvp (progname, argv) 
char * progname, * argv 口 ； 



r 解脱 i 

execvO, execvpO は どちらも 別の プログラム ファイル を 読み込み， それ を 実行し ます. 文字 
列 progname に は， 実行すべき ファイル 名 を 与えます. ファイル 名が 拡張 子 を 持たない 場合に 
は， .com が 仮定 されます. progname で 指定 した フ アイ ル がない 場合 に， execv( ) は "cannot 
exec ： く progname> "と 標準 エラー 出力に 出力して 関数から 戻って きます. しかし， execvp ( ) 
は 環境 変数 PATH の 示す ディ レク ト リ から 探します， それでも 見つからな いと execvp() は 
"cannot exec ： く progname〉 "と 標準 エラ一 出力に 出力して 関数から 戻って きます. 

実行す る コマンドへの パラメータ は， コマンド 引数の アドレスの 配列 を 作って おき， それ をバ 
ラ メータ argv として 与えます. また 配列 argv の 最後の 要素に は 値 NULL を 入れます. つまり， 
argv[0] に はじめの 引数の アドレス， argv[l] に 2 番目の 引数の アドレス， という 順に 収め， 最後 
に NULL を 入れます. 

現在 オープンされ ている 低水準 入出力 ファイル は オープン された まま 指定の コマンドが 実行 さ 
れ ます. 5 つ の 標準 入出力 ファイル は リダイレクトな どが さ れて いれば， 起動され た コマンド でも 
そのままと なります. 

static char *para»[]=t 

"all work", "and", "no play", "makes", w Jack w , "a dull boy ノ，， NULL 
}； 

execvCfoo", paran); 



は， コマンド 行から 

A>foo all work and no play makes Jack a dull boy. 0 

と 入力した のと 同じ 効果 を 持ちます. 
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戾り佃 I 

ありません. 



参照 1 

execK )， execlp( ) 



厂 注意 I 

execv() は， プログラム 力ぶ 見つからな いとき， 関数から 戻って くるよう に 動作が 変更され まし 
た. 

execvp( ) は Ver，1.2 から 標準 ライ ブラ リ に 追加され ま した. 

execvp( ) は progname に ドライ ブ名ゃ ルー 卜 ディレクトリから の 指定が あ ると， ファイル を 
環境 変数 PATH の 示す ディ レク ト リ から 見つける ことができません. 



厂例， 

^include <stdio.h> 

/* 

プログラムが 始まる こと を 表示して から， ひとつ 目 以降の パラメ一 夕 を 

コマンド 列と して 起動 

*/ 

ma in urge, argv) 
int &rgcS 
char *argv[]i 
{ 

if (argc > 1) { 

printf ("Start program %s¥n", argv[l]); 
execvp(argv[l], &argv[2]); 
/* コマンドが 見つからない */ 
puts( M Sorry...¥n M ); 

} 

) 
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第 6 章 標準 ライブラリ 関数 リファレンス 



exit, 一 exit 



厂害式 I 

# include < process.h > 

VOID exit(code) 
int code ； 

VOID exit(code) 
int code ； 

I 解脱 I 

実行 4i の コマンド を 中止して コマンド レベルに 戻り ます. この 時リ ターン コ一ド （code) を 指定 
して 戻る ことができます. また， exit() は 高水準 入出力の すべての バッファ を フラッシュ， クロ 
ーズ します. それに 対して _exit() は フラッシュ， クローズ をし ません. です が， 低水準 入出力の 
ファイル ハンドル は， exit()， _exit() のどち らも クローズ します. 



逄 意 | 

exit( ) は Ver. 1 .2 から 標準 ライブラリ に 追加され ま し た. 



例 I 
^include <stdio.h> 

iain() 

{ 

FILE *fp; 

/* file.dat がなかったら" File not found" を 表示して プログラム を 終了 */ 
if «fp = fopen( M file.dat w , M r w )) NULL) { 
putsCFile not found¥n n ); 
exit(l); 

} 

} 
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expargs 



厂害式 i 

# include く direct, h> 

int expargs(argc, argv, maxargc, xargv) 
int argc, maxargc ； 
char *argv[], *xargv[] ； 

I 解脱 I 

ワイルド カード を 含む コマンド 引数に 対し， 実際に ディ レクト リサーチ をす る ことによって そ 
れを 各々 の ファイル 名に 展開す る閧 数です. ワイルド カードが 含まれて いる ときには， 展開され 
た ファイル 名 を ソートし ます. 複合 ファイル スペック も 指定す る ことができます. ただし， ファ 
ィル スペックの 区切りと して は" + " しか 使う こと はでき ません. この 関数 を 利用す ると， ワイル 
ド カード 文字 を 実際の ファイル 名に 展開す る 機能 を 持つ プログラム を 書く ことができます. 

パラメータ argc, argv は 展開す る 引数の 数と 文字列への ポインタの 配列です. xargv も argv 
と 同じ 文字列への ボイ ンタの 配列で あり， そこに は 展開され た 各々 の コマンド 引数の ァ ドレス カミ 
セット されます. また， xargv の 大きさ を maxargc として 与えます. 

戻り 値 | 

展開され た コマンド 引数の 個数が 関数の 値と して 返されます. ただし， 引数 を 展開す る メモリ 
が 不足した 場合と 展開 後の 引数の 個数が maxargc を 越えた 場合に は， 値 ERROR が 返されます. 

I 逢窻 I 

戻り 値と して ERROR 力 《返された 場合に は， 配列 xargv[] の 内容 は 無効です. 
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第 6审. 標準 ライブラリ 関数 リファレンス 



I 例 I 

^include <stdio.h> 
#define MAXARG 100 
char «xargvCKAXARG]; 

/* バラ メータの ワイルド カード を 展開して 表示 */ 

■ain(argc f argv) 

int argc; 

char *argv[]; 

{ 

int i， n; 

if (argc > 1) { 
argc --； 
argv++; 

n = expargsCargc, argv, MAXARG, xargv); 
for (i = 0； i < n; 

printf( w Mn M , xargv[i]); 

} 

} 
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fclose, fcloseall 



厂害式 i 

# include <stdio.h> 

STATUS fclose(fp) 
FILE *fp ； 

TINY fcloseall( ) 

厂 解脱 I 

fclose( ) は fp で 示された ファイル を クローズ します. fclosealK ) は stdin, stdout, stderr, 
stdaux, stdprn 以外の オープンして いるすべ ての ファイル を クローズ します. テキスト モードで 
かつ ライト モードであった ときには a Z ( EO f 文字） を 出力して から クローズ します. また， ファ 
ィル バッファ を システムが 自動的に 割り当てたなら， それ を 解放し ます. fdose() では 高水準 入 出 
カフ アイ ル のみ を 閉じる こ とがで きます. 低水準 入出力 ファ ィ ルに は close( ) を 使って 下さ い， 
exit() で 終了したり， プログラムが 正常終了した ときには， すべての ファイル を fdose() で クロ 
ーズ してから コマンド レベルに 戻り ます. 

1 戻り 値 I 

fclose( ) は fp が NULL であったり， ク ローズの 処理に 失敗した 場合に は ERROR が 返され ま 
す. それ 以外で は 0K が 返されます. 

fclosealK ) は ひとつで も ファイルの クローズ に 失敗す る と ERROR を 返します. クローズ にす 
ベて 成功す ると クローズした フ アイ ルの数 を 返 します. 



逢 窓 I 

fclosealK ) は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した. 
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第 6 章 標準 ライブラリ 関数 リファレンス 



_m ] 

jtinclude <stdio.h> 

廳 ain() 
{ 

FILE *fp; 

/* ファイル を エンド ォブ ファイルまで 銃み 込んで， クローズして 終る */ 
if ((fp = fopen( M file M , "r") == NULL) { 
puts( w FUe not foundVn M )l 
exit(i); 

) 

puts( M Start!I!¥n w ); 

while ((c = getc(fp)) != EOF) 

putchar((char)c); 
Puts( M End of file¥n w ); 
fclose(fp); 

} 
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feof 



「害 式 

# include <stdio.h> 

BOOL feof(fp) 
FILE *fp ； 

I 解説 1 

ファイル を 最後まで 読み込ん だか どうか を 調べます. ファイル は 最後 （エンド ォブ ファイル， 
EOF) まで 読み込む と， それ を 表す フラグが 立ちます. それ を 見る のが feof () です. EOF は テキ 
ス ト モード か， バイナリ モー ド かによ つて 位置が 変わり ます. テキス 卜 モードの ときには EOF 文 
字 fZ) が エンド ォブ ファイル を 示し， バイナリ モードで は 物理的な ファイルの 終端が エンド ォブ 
ファイルになります. EOF の 状態 をクリ ァす るに は clearerrO を 使います. 

「 戻り 傕 | 

EOF まで 読み込ん でいた 場合に は TRUE を 返します. そうでない 場合に は FALSE を 返し ま 
す. 



「参照つ 

clearerr^ ), eoh j 

I 注意 1 

この 関数 は マクロです. 

この 関数 は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した. 
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I m | 

itinciude <stdio.h> 

sainO 

{ 

int i : 10； 
char c; 

A 

標準入力の 文字 を 1 0 文字 出力す る. エンド ォブ ファイルと なったら 

スペース を 表示す る. 

*/ 

while (i && (c = getcharO) t= EOF) { 
putchar(c); 
卜-; 

) 

If (feof(stdin)) 

while (i— ) 

PutcharC 0； 

} 
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ferror 



i 書式 i 

# include <stdio.h> 



BOOL ferror(fp; 
FILE *fp ； 



I 解説 1 

ファイルが 書き込み 中に エラーが 発生した かどう か を 調べます. これ は 主に ディスク フルに よ 
つて 発生し ます. エラー の 状態 をク リアす るに は clearerr ( ) を 使います. 



戻り 値 | 

エラー が 発生 していたら TRUE を 返します. そうでな いとき は FALSE を 返します. 



厂 注意 1 

この 関数 は マクロです. 

こ の 関数 は Ver . 1 . 2 から 標準 ライブラリ に 追加 さ れま した. 



例 



{include <stdio.h> 

sainO 
{ 

FILE *f P ; 

/* ディスクが いつば いになる まで デ一 タを窖 き 込む */ 
if ((fp = fopen("noBore", V,)) == NULL) 

exit(l); /* file cannot sake %l 

while (！ ferror(fp)) 

fputsC'Write until disk full¥n w , fp); 
fputs("Disk full l!!¥n", stderr); 

) 
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fflush 



I 書式 I 

# include <stdio.h> 

STATUS fflush (fp) 
FILE *fp ； 



厂 解脱 1 

ファイルの バッファ を ディスクに 書き出します. 高水準 入出力 関数で は ファイルに 出力され た 
データ は バッファに 1 度 格納され ます. その バッファが いっぱいに なると 自動的に ディスクに 書 
き 出します （バッファの フラッシュ という） が， 強制的に fflush() によって バッファの 内容 をバッ 
ファフ ル になる 前に ディスクに 書き出し， ノ s ッファ を 空に します. 標準出力に 改行 文字 (¥n) なし 
で 文字列 を 表示 したい ときには ffl us h( ) を 使 う 必要が あ ります. フラッシュした 後 も ファイル は 
オープン された 状態です. 



厂 戻り 値 I 

ノ s ッファ の フラッシュが 成功した とき は 0K を 返します. ディスク フルの ときには ERROR が 
返されます. 



# 照 1 

「4.3.1 B) 高水準 入出力 M 数の バッファリング」 
flushallO 



tx. ― %h J 

ファイル を クローズした とき や， プロ グラムが 正常終了した ときに は 自動的に バ ッファ をフラ 
ッシュ し， 空に します. 

こ の 関数 は Ver. 1 -2 か ら 標準 ライ ブラ リ に 追加され ま した. 
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tinclude <stdio.h> 

nainO 

{ 

int i, sud; 
/* 途中 経過 を 表示しながら 100 までの 和 を 計算し ます. */ 

SUB = 0； 

for (i = 0； i <= 100； i++) { 
sun += i; 

printf( w X4d X5d¥r", i, sun); 
ff lush(stdout); 

) 

printf( M sun = Xd¥n M , sun); 
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fgets 



厂害式 I 

# include <stdio.h> 



char * fgets (s, n, fp) 

char *s ； 

int n ； 

FILE *fp ； 



厂 解脱 I 

fp で 示された ファイルから 文字列 を 読み込みます. 文字列 は" ¥n "を 終わりと して， s で 示され 
る 領域に 読み込みます. また， 領域の サイズ を】 1 によって 指定し ます. 文字列の 最後に は" ¥n "が 
つき， その後に 文字列の 終了 文字と して" ¥0， 'が 入ります. 読み込んで いる 最中に ファイルが ェン 
ド才ブ ファイルに 達した 場合 は "¥n "は 入らずに" ¥0" が 置かれます. feets( ) は 最大で n_l 文字 を 
読み込み 最後に" ¥0" を 置きます. 



厂 展り値 | 

ファイルが エンド ォブ ファイルに 達した とき と， 何も 読み込まれなかった とき は NULL が 返 
されます. それ 以外の 時 は s が 返されます. 



參 照 1 

gets^ h fputs( )， puts( ) 



I 例 I 

^include <stdio.h> 
char buf[2563; 

園 ain() 
{ 

FILE *fp; 
/* フ アイ ル neno の 内容 を 表示す る */ 

if ((fp = fopen( M nemo M , w r")) == NULL) { 
puts( w File not found¥n w ); 
exit(l); 

) 

while (fgets(buf, 256, fp)) 

puts(buf); 
fclose(fp); 

} 
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fileno 



厂害式 i 

# include <stdio.h> 

FD fileno(fp) 
FILE *fp ； 



I 解脱 1 

fp で 示される ファイルの 入出力に 使用して いる ファイル ハンドル を 返します. 高水準の フ アイ 
ル 入出力 は， 必ず ひとつの 低水準 入出力の ファイル ハンドル を 持って います. ファイル ポインタ 
から その フ アイ ルハン ドルの 値 を 得る ときに fil eno ( ) を 使います， 



厂 戻り 値 ， 

対応す る ファイル ハンドル を 返します. fp が オープンされ ていない ファイル である 場合に は, 
値 は 保証され ません， 

I 注意 I 

この 関数 は マクロです. 

この 関数 は Ver . 1 . 2 から 標準 ライブラリに 追加され ました. 



_m ] 

Kinclude <stdio.h> 

■ain() 

{ 

FILE *fp; 
h stdin から 

stdprn までの 対応す るフ ァ ィ ルハン ドル を 表示す る */ 
for (fp = stdin; fp <= stdprn; fp++) 

printf( tt file handle Mn"， fileno(fp)); 

} 
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flushall 



厂 書式 I 

# include <stdio.h> 
TINY flushalK ) 



解 脱 ] 

ライ トモ一 ドで オープンされ ている すべての ファイルの バッファ を ディスクに 書き出します. 
フラッシュした 後 も ファイル は オープン された 状態です. 



厂 戻り 傕 つ 

オープンされ ている ファイルの 数 を 返します. これに は リード モード， ライト モードの 区別 は 
ありません. 

I 参照 I 

fflush ( ) 

I 逢 意 I 

ファイル を クローズした とき や， プログラムが 正常終了した ときには 自動的に バッファ をフラ 
ッシュ し， クローズ します. 
この 関数 は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した. 



jM | 

^include <stdio.h> 

匿 ainO 
{ 

TINY file; 

A いくつ ファイル を オーブンして いるか を 表示す る */ 
file = flushalK); 

■ntf( M Xd files are operrfn", (int)file); 

} 
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fopen 



厂 書式 i 

# include <stdio.h> 

FILE *fopen(filename, mode[, bufsize]) 
char *filename, *mode ； 
size t bufsize ； 

解 脱 1 

filename で 示される フ アイ ルを 高水準 入出力が 行え るよう に オープン します. 文字列 mode は 
次の う ち のい ずれ かで な ければ な りません. 



"r" 


リード モー 


ド， テキスト モー 


K 


"rb" 


リード モー 


ド， バイナリ モー 


K 


，，w，， 


ライ トモ一 


ド， テキス トモ 一 


F 


，Vb，， 


ライ トモ 一 


ド， バイナリ モー 


ド 


"a" 


ァ ペン ドモ 


ード， テキス トモ 


—ド 


"ab" 


ァ ペン ドモ 


—ド， バイナリ モ 


—ド 



リード モード は 読み出し のために あり， ファイルが 存在し なければ なりません. ライト モード 
は 書き込み 用で， ファイルが すでにあった ときにはまず， その ファイル を 消してから オープンし 
ます. つまり， いままでの 内容 は 消えて しまいます. アペンド モード はい まある ファイルに デー 
タを 追加す るた めに 使います. ファイルがない とき は ライ ト モードと 同じ 動作になります， 

テキスト モードと は 入力 時 は "¥r" + "¥n" を" ¥n "の 1 文字に， 出力 時 は "¥n "を" ¥r" + "¥n "の 2 
文字に 変換し， を エンド ォブ ファイル とする， ファイルの 入出力 モードです. モードの 2 文字 
目に" b" を 指定 しないと テキス ト モードになります. ソースファイル などの 入出力に 使われます. 

バイナリ モードで は テキス トモ一 ドと 違って 入力 時" ¥r" + "¥n"， 出力 時の "¥n" などの 変換 は 
一切し ません. また， も エンド ォブ ファイルに しません. 

bufsize に は 入出力に 使われる バッ フ ァの サイ ズを 指定で き ます. 省略され た ときには 
BUFSIZ(1024) になり ます. 



戻り 値 1 

フ アイ ルの オープン 数が 多過ぎた り， フ アイ ルが 見つか ら なかった 場合に は NULL が 返され 
ます. オープンに 成功す ると FILE 構造体への ポィ ンタが 返されます. 



参 照 1 

fsetbin( ), fsettext( ), setbuf( ), setvbuf ( ) 
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洤 意 | 

fopen( ) は 可変 パラメータ 関数な ので， 

FILE *fopen(.)l 



という 宣言が 必要です， この 宣言 は， ヘッダ ファイル stdio.h に 含まれて います. 



^include <stdio.h> 
char buf[2563; 

■ain() 

{ 

FILE *fp; 
/* ― 
フ アイ ル newgame.dat の 内容 を 表示す る. ― 
ファイルがなければ" File not found" を 表示す る • 
*/ 

if ((fp = fopenCnewgane.dat". "r") NULL) { 
fputsCFile not found¥n M , stderr); 
exit(l); 

} 

while (fgets(buf, 256, fp)) { 

puts(buf); 
fclose(fp); 
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fprintf 



# include <stdio.h> 

fprintf (fp, format[, argl , arg2, ...]) 
*fp; 

♦format ； 



r 解説 i 

fprintf( ) は fp で 示される フ アイ ル に対して 書式 付きの 出力 を 行ない ま す. 制御 文字列に つい 
て は， printf() と 同じです ので その 項 を 参照して 下さい. 



厂 戻り 値 | 

出力 中に エラーが な ければ 0K が 返されます. そうでな ければ ERROR が 返 され ま す 

I 参照 I 

print f( )， sprintf( ) 



一 注 意 — | 

printf( ) は 可変 パラメータ 関数な ので， 次の 宣言が あらかじめ 必要です 
STATUS fprintf (•); 

この 宣言 は， ヘッダ ファイル stdio.h に 含まれて います. 
fprintf ( ) は UNIX の 標準 C の サブセット になって いま す. 



STATUS 
FILE 

char 
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1 ~~ I 

# include <stdio.h> 

■ain() 

{ 

FILE *fp; 
int array 匸 10〕； 
int count; 
/* 整数の 配列 を ファイル intdat.dat に 保存す る */ 

if ((fp = fopen( w intdat.dat w f "w")) == NULL) I 

fprintf(stderr, "File cannot aake^n M ); 

exit(l); 

) 

for (count = 0； count < 10； count++) 

fprintf(fp, "Xd¥n"， arrayCcount]); 
fclose(fp); 

} 



157 



fputs 



I 書式 1 

# include <stdio.h> 



STATUS fputs(s, fp) 
char *s ； 
FILE *fp ； 



厂 解脱 I 

ファイル ポインタ fp で 示された ファイルに 文字列 s を 出力し ます. 出力に 対して 文字列 の 最後 
に" ¥n" をつ けたり はしません. 文字列 s は ヌル 文字で 終って いなければ なりません. また， ヌル 
文字 は 出力され ません. 文字列 中に" ¥n "があった 場合に は テキスト モー ド であれば" ¥i ""と" ¥n" 
にして 出力し ます. 



f 戾り値 1 

出力 中に ェ ラ 一が 発生した 場合に は ERROR が 返されます. それ 以外の とき は 0K が 返 され ま 
す. 



# 照 1 

fgets( )， gets( )， puts( ) 



厂 例 

^include <stdio.h> 
char buf[256]; 

nainO 

{ 

FILE *fp; 

/* キーボードからの 入力 を ファイル 麗 eino に 保存す る */ 
if ((fp = fopen ("蘭 eno", Y)) == NULL) { 

puts( w File cannot 讓 akelfii M )*, 

exit(l); 

} 

while (gets(buf, 256)) 
fputs(buf, fp); 
fclose(fp); 

} 
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fread 



I 害 式 I 

# include <stdio.h> 

int fread (buf, size, count, fp) 

char *buf ； 

int size, count ； 

FILE *fp ； 



[解脱 1 

フ アイ ルポ ィ ンタ fp で 示される フ アイ ル から buf で 指定され た 領域に size バイ ト を count 回 
(項 H), データ を 読み込みます. fread() は， 低水準 入出力 閧 数の read( ) の 高水準 入出力 関数 版 
と 考えれば いいでしょう. 読み込む データ 量 は 単純な バイ ト数 ではなく， どういう 型 (size) の もの 
を どれ だけ (count) 読み込む かで 指定 します. 

I 戻り 値 | 

読み込む こ とがで きた 回数 (項目 数） を 返します. ファイルが エンド ォブ ファイルであった とき 
に は 0 になります. 

I 参照 I 

fsetbin リ， fvvrite( ), read( ) 

I 注意 I 

読み込む データが バイ ナ リ データであるなら fsetbin( ) をす るか， バイ ナ リ モードで fopen( ) 
する 必要が あります. 

この 関数 は Ver. 1.2 から 標準 ライ ブラ リ に 追加され ました. 
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例 



•include <stdio.h> 

■ain() 

{ 

FILE *fp; 

Int array[10]; 

int count; 

/* 整数の 配列 fc バイナリ 形式で 保存して ある データ を 読み込む */ 
/* バイナリ モードで オーブン */ 
if «fp = fopenCworddat.dafp w rb w )) == NULL) { 

puts( w File not foimcHfn"); 

exit(l); 

} 

count = freed(arrey, sizeof(lnt), 10, fp); 

} 
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free 



厂害式 I 

# include <malloc.h> 

VOID free(ap) 
char *ap ； 



厂 解 K 1 

albc() で 割り当てられた 領域 (ap で 示す） を 解放し， 再 利用 を 可能に します. a】loc( ) と free( ) 
は 高水準 メモリ 管理 関数で， 組合せて 使用され ます. allod) は 実行時に その 状況に 応じて 領域が 
必要な ときに 使い， freeO は その 領域が 不要に なった ときに 使います. free() によって， 限り あ 
る メモリ を 有効に 使う ことができます. 詳しく は 「4.3.3 メモリ 管理 関数」 を 参照して 下さい. 



戻り 値 | 

ありません. 

I 参照 I 

allocC ), rsvstkv ；, sbrk( ) 

I 注意 I 

free() で 解放され た 領域で n バイ ト 以上の 領域がない 場合に は sbrk( ) で 領域 を 確保し ようと 
します. つまり n バイト alloc() し， 直後に そこ を free() してから， （n+m) バイト alloc( ) しょ 
う とすると （(n + sizeof (HEADER)) + (n+m+sizeof (HEADER))) 以上の メモリが 必要に な 
ります. 
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例 I 

it include <stdio.h> 
char bufClOO]; 



nainO 
{ 



char 本 p, **ary; 
int n = 0； 

/* キーボードからの 人力 を 逆順に 表示す る */ 

if ((ary = (char **)alloc(slzeof(char *) * 100)) == NULL) I 

puts( w Not enough menory¥n"); 

exit(l); 

} 

while (gets(buf, 100)) { 

if ((p = aIloc(strlen(buf)+D) == NULL) { 
/* 入力の 分 だけ 傾 域 を 取る */ 
fputs( w No wore Bemory¥n", stderr); 
break; 

} 

strcpy(p, but); 
ary[n++] = p; 

} 

while (n) { 



h 確保され てる 傾 域に セーブ 
/* 頒 域への ポインタ を セーブ */ 



rree(ary[n— ])； 

} 

free(ary); 



/* 1 行 を 表示 */ 
/* 文字列に 使った 頗域も 解放す る ま/ 

/* 配列に 使った 領域 を 解放す る */ 
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fscariT 



厂害 式， 

# include < stclio.h > 

int fscanf(fp, format [, arg1 , arg2, •"」) 
FILE *fp ； 
char * format ； 



厂 解脱 1 

fscanf ( ) は fp で 示された ファイルから ® 式 変換 付 きの 入力 を 行な います. format 以降の パ ラ 
メータ は scanfO と 同じな ので その 項 を 参照して 下さい. 



厂 戻り 値 つ 

fscanf() は， 実際に 代入され た 項目 数 を 値と して 返します. 戻り 値が 1 で， 変数への ポインタ 
を 3 個 パラメータに 指定したら， 2 個 R 以降 は 値が 代入され ていない ことになります. また， ファ 
ィ ルの 終わ り に 到達 し た 時に は 値 EOF が 返 されます. 



厂 参照 1 

scanf( )， sscanf^ ) 

注 意 I 

"%c "で 文字 を 代入す ると き は ラインフィード 文字 "¥n" が 代入 されて しまう こと もあります の 
で， 変換 文字の 指定に は 注意して 下さい. fscanf () は 可変 パラメータ 関数な ので， 次の 宣言が あ 
ら かじめ 必要です. 

int fscanf(.); 

こ の 宣言 は， ヘッダ ファイル stdio.h に 含まれて いま す. 
fscanf ( ) は UNIX の 標準 C の サブセット になって います. 
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例 I 

^include <stdio.h> 
char buf[100]; 

iiainO 

{ 

int val, n; 
char c; 
FILE *fp; 

/* ファイルから 1 0 進数， 文字， 文字列 を 受け取る */ 
if ((fp = fopenC*file.dat w f w r")) == NULL) { 

Puts("FUe not found¥n"); 

exit(l); 

) 

n = fscanf(fp t w Xd Xc Xs". &va し &c, buf); 

printfCXd iatched decimal Xdtchar 'J£c，：string 'Xs'¥n，，， 

n, val, c, buf) 
fclose(fp); 

) 
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第 6 章 標準 ライブラリ 開 数 リファレンス 



fsetbin 



I 害 式 I 

# include <stdio.h> 

STATUS fsetbin(fp) 
FILE *fp ； 



厂 解説 1 

fp で 示された ファイル を バイナリ モードと して アクセス する. バイナリ モードで は テキス トモ 
ードと 違って 入力 時" ¥r" + "¥n"， 出力 時の "¥n" などの 変換 は 一切し ません • また， 〜z も エンド 
ォブ ファイルに しません. エンド ォブ ファイルになる に は 物理的な フ アイ ルの 終端に 達 したと き 
です （ファイルの 長さで 判定す る）. fopen() で ファイル を オープン する ときに も バイナリ モー ド 
にす る こ とがで きます. モー ドの 2 文字 目に" b" を 加えます. 

作成した ファイルに コマンド レベルで リ ダイ レク ト マーク （〉〉） によって データ を 追 iJt! したい 
ときに は， fdose( ) を 実行す る 前に fsetbin( ) を 実行 すれば 可能です. これ は バイ ナリ モードで あ 
れば ^ Z が 出力され ない ので， それに よって フ アイ ルが 区切られない ためです. 

I 戾り值 | 

必ず 0K が 返されます. 



参 照 | 

fopenv ；, fsettextv ； 
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I 伊 J I 

^include <stdio.h> 
char buf[256]; 

nain() 

{ 

int i, c; 
FILE *fp; 

/* まず は バイナリ モードで オープン */ 

if ((fp = fopen( M str.dat". "rb")) == NULL) { 

PutsC'File not founds"); 

exit(l); 

} 

while ((i = getc(fp)) t= EOF) { /* 文字列の 数 を 受け取る */ 

fsettext(fp); /% これから 先 は テキス トモ 一 ドで 読み込む */ 
while (卜-) { /* 整数 分 だけ 文字列 を 表示 */ 

fgets(buf, 256)； 

puts(buf); 

} 

fsetbin(fp); /* 整数 を 取る ために バイナリ モードに */ 
fclose(fp;; 

} 
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第 6草： 標略 ライブラリ 関数 リファレンス 



fsettext 



厂害式 I 

# include <stdio.h> 

STATUS fsettext(fp) 
FILE *fp ； 



し 解 Bi j 

fp で 示された ファイル を テキス ト モードと して アクセス する. テキス ト モードと は 入力 時 は 
"¥r" + "¥n" を "¥n" の 1 文字に， 出力 時 は "¥n "を "¥r"+"¥n" の 2 文字に 変換し， を エンド ォ 
ブ ファイル とする， ファイルの 入出力 モードです. fopen() によって オープン された ファイルの 最 
初の 状態 は テキスト モードと なって います. 



「 戾り値 _ | 
必ず 0K を 返します. 

I 参照 j 

fopen( )， fsetbin( ) 



I 例 I 

#includ6 <stdio.h> 
char buf[256]; 

DainO 
{ 

直 nt i， c; 
FILE *fp; 

A まず バイナリ モードで オープン */ 

if ((fp = fopen( w str.dat M f n rb n )) == NULL) { 

putsCFile not foundVn M )i 

exit(l); 

} 

c = getc(fp); /* ファイルの 先頭の 2 バイ トを 整数と する */ 
i = c + getc(fp) * 256； 
f set text (fp); /* これから 
先 は テキスト 乇一ド で 読み込む */ 

while (i-) { /* 整数 分 だけ 文字列 を 表示 */ 
fgets(buf, 256)； 
puts(buf); 

} 

fclose(fp); 

} 
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fwrite 



厂 書式 i 

# include <stdio.h> 

int fwrite(buf, size, count, fp) 

char *buf ； 

int size, count ； 

FILE *fp ； 



解 脱 I 

fp で 示される フ アイ ルに buf で 指定され た 領域 か ら size バイ ト を count 回 (項目） のデー タ を 
書き込みます. fwrite( ) は， 低水準 入出力 関数の write( ) の 高水準 入出力 関数 版 と 考え れ ばいいで 
しょう. 遒き 込む データ 量 は 単純な バイ ト数 ではなく， どういう 型 (size) の もの を どれ だけ 
(count) 書 き 込む かで 指定 します. 



厂 戻り 傕 1 

書き込む ことができた 回数 (項目 数） を 返します, 

I » 照 I 

fread( ), fsetbin( ), write ( ) 



こ 注意 i 

書き込む データ が バイ ナリ データであるなら feetbin( ) をす るか， バイナリ モードで fopen( ) 
する 必要が あります. 
この 関数 は Ver，1.2 から 標準 ライ ブラ リ に 追 力 n されました. 
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第 6 章 標準 ライブラリ 阕 数 リファレンス 



厂 例 I 

^include <stdio.h> 

■ain() 

{ 

FILE *fp; 

int array[10]; 

Int count; 

/* 整数の 配列 を バイナリ 形式で ファイル worddat.dat に 保存 */ 
/* バイナリ モードで オーブン */ 
if ((fp = fopen("worddat.dat", W)) == NULL) { 

puts("File cannot nake¥n") ； 

exit(l); 

} 

for (count = 0； count < 10； count++) 
scanf("Xd'\ &ar ray [count]); 
count = fwrite(array, sizeof(int), 10, fp); 

} 
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gstc, getchar 



i 害 式 i 

# include <stdio.h> 

int getc(fp) 
FILE *fp ； 

int getchar( ) 

I 解脱 I 

getc( ) は fp で 示される フ アイ ルか ら 1 文字 読み込み ま す. getchar ( ) は 標準入力 か ら 1 文字 読 
み 込みます， ファイルの 終端 (エンド ォブ ファイル） に 到達した 時 は， 値 EOF を 返します. 

I 戻り 値 I 

フ アイ ルの 終わ り を 越えて 読み込んだ 時 は EOF を 返します. そうでな いとき は 読み込んだ 文 
字 を int 型に して 返します. 

I 参照 1 

getch( )， getche( ) 



法 意 ] 

デバイス （キー ボ一 ド） から 文字 を 読み込む と き は， MSX-D0S2 の 仕様に よって 行バッ ファリ 
ングが 行われます. つまり， リターン キーが 押される まで は getc()， getchar() から 戻って きま 
せん. getc() と getcharO は， int 型の 値 を 返します. 



_m ] 

^include <stdio.h> 

■ainv; 

{ 

FILE *fp; 

/* プア ィルを 最初から 最後まで 表示 */ 
if ((fp = fopen(，，file，，， "r，'〉 == NULL) { 

puts( M File not found¥n"); 

exit(l); 

} 

puts( w Startt!!¥n w ); 

while ((c = getc(fp)) != EOF) 

putchar((char)c;; 
puts("End of file¥n M ); 
fclose(fp); 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



getch 



厂 書式 I 

ff include <conio.h> 
char getch 、 ) 
I 解脱 I 

標準入力 （ファイル ハンドル 0) から エコーバック なしで 1 文字 入力 します. getch( ) は 入力 待ち 
をし， 1 文字 入力 される とそ の 文字 を 返 します. Ctrl+C や Ctrl+Z などの コント 口 一ル 文字 も 入 
力す る ことができます. 行 バッファリングが 行われません （テンプレート は 使用で きない）. EOF 
が 存在 しないた め， 標準入力 が リダイレクトされ ている 場合に は， eof( ) で エンド ォブ ファイル か 
どうか を 調べた 方が いいでしょう. また， read() で 標準入力 （ファイル ハンドル 0) から 読み込ん 
だり， getchar() などで stdin から 読み込む など， 他の 読み込み 関数との 混用 は 避けた 方が いいで 
しょう. 



戻り 値 | 

入力 さ れた 文字が 返 されます. 文字と して Ctrl+C や Ctrl +Z も 入力で きます. 



• 照 | 

eof( ), getche に ) 

}± 意 | 

この 閼数は Ver 丄 2 から 標準 ライ ブラ リに 追加され ました. 
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例 



# include <stdio.h> 

int get() 
{ 

if (eof(STDIN)) 

return (EOF); 

else 

return (getchO); 

} 

/* 標準入力から 入力され た 文字 を 表示 */ 
nainO 

{ 

int c; 

while ((c = getO) != EOF) { 
if (c < ， ，） （ 

putchar('*')J 
c += '0'； 

} 

putchar((char)c); 
ff lush(stdout); 

} 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



getche 



厂害式 

# include <conio.h> 



char getchet ) 



厂解股 1 

標準入力 （ファイル ハンドル 0) から エコーバック つきで 1 文字 入力 します. getche( ) は 入力 待 
ち をし， 1 文字 入力され ると その 文字 を 返します. エコーバック は 標準出力 （ファイル ハンドル 1) 
に 出力され ます. Ctrl+C や Ctrl+P などの コントロール 文字 は， その 文字の 機能と して 働き ま 
す. 1 文字 ごとの 入力が 行われる ため， 行 バッファリング は 行われません （テンプレート は 使用で 
きない). また， EOF が 存在し ないた め， 標準入力が リダイレクトされ ている 場合に は， eof() で 
エンド ォブ ファイル かどう か を 調べた 方が いいでしょう. また， read() で 標準入力 （ファイル ハン 
ド ル 0) か ら 読み込んだ り ， getchar( ) などで stdin から 読み込むな ど， 他の 読み込み 関数 と の 混用 
は 避けた 方が いいでしょう. 



戻り 値 | 

入力され た 文字が 返 されます. 



参 照 I 

eof リ， getch( ) 



厂 注意 I 

この 関数 は Ver 丄 2 から 標準 ライ ブラ リ に 追加され ま した. 



_m ] 

^include <stdio.h> 

nainO 

{ 

while (1) { 

putchar(getcheO); 
ff lush(stdout); 

) 

} 
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getcwd 



害 式 i 

# include <direct.h> 

char *getcwdvcwd, n) /* get current work directory * 

char *cwd ； 
int n ； 



厂 解脱 1 

カレント ドライブと カレント ディレクトリ を d: ¥path の 形で 返します， cwd に は カレント デ 
ィ レク ト リ名を 格納す る 領域への ポインタ を， n に は その 大きさ を 指定し ます. cwd が NULL で 
ある ときには getcwd() が 領域 を 自動的に 割り当てます. n が カレント ディ レクト リを 格納す る 
のに， 不足す るよう な 値であった ときには， 領域い つばい に 格納し， 残り は 切り捨てます. MSX 
-D0S2 では ファイル 名 は 63 文字 以下 と 規定され ています ので， 最低で も 64 バイト の 領域 を 確保 
してお けば 確実です. 

1 戻り 値 | 

カレント ディレクトリ 獲得 失敗 か 自動的な 領域 確保に 失敗した 場合に は NULL を 返します. 
そ の 他の 場合に は カレント ディレクトリ を 示す 文字列への ポィ ンタを 返します， 

I 参照 I 

chdir(), mkdir( ), rmdir( ) 



注 意 | 

カレント ディ レク ト リが ルート ディ レク ト リ であった 場合に は， 最後に" ¥ ，，がっきます. 
この 関数 は Ver . 1 . 2 から 標準 ライ ブラ リ に 追 力 n されました. 



例 1 

Itinclude <stdio.h> 
char cd[64] ； 

■ain() 

{ 

chdir( M ¥¥ n ); /* カレント ドライブ は A だとす ると */ 

getcwd(cd t sizeof(cd)); 

puts(cd); /t 9 k:r と 表示され る */ 

chdirCbin"); AA ドライブ は ディ レク ト リ bin を もつ */ 

puts(getcwd(cd, sizeof(cd)));/ 本， A:¥BIN， と 表示され る 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



getenv 



厂害式 1 

ff include <stdlib.h> 

char * getenv vvar) 
char *var ； 



解 脱 1 

MSX-D0S2 の 環境 変数 値 を 獲得し ます. var に は 獲得したい 環境の 変数 名 を 指定し ます. 変数 
値 は 戻 り 値が 示す 領域に 文字列 として 入って います. 変数 地 を 格納す る 領域 は 毎回 alloc( ) に よ 
つて 割り当てられ るので， 不要に なったら free ( ) で 解放す る ことができます， 

環境 変数 は MSX-DOS の SET コマンド や， putenv( ) によつ て 設定 し ま す. 

I 戻り 値 | 

変数が 見つか ら なかった り ， 変数 値 を 格納す る だけの 領域が 確保で きなかった とき は NULL 
を 返します. そうでな いとき は， 変数 値の 格納され ている 領域 を 返します. 

I 参照 I 

alloc( )， free\ ハ putenvv ) 

I 注意 I 

こ の 関数 は Ver . 1 . 2 から 標準 ライ ブラ リ に 追加され まし た. 
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例 



tinctude <stdio.h> 

A テンポラリ ファイル を 作る */ 

char *aktiip(fn) 

{ 

char *p; 
static int 瞧 = 0； 

if ((p = getenv( w TMP M )) NULL) Atapfc 使う ディ レク ト リを獏 得 */ 

P - w a: 『； 
strcpy(fn, p); 

P = f n + strlen(fn); /* points at f W */ 

if (*(p - 1) != •¥¥，） 

*P++ = f Wl 
sprintf(p f w tnpJ!03d •$$$", nun++); 
return (fn); 

} 

鼠 a In Urge, argv) 
int argc; 
char 本 argv 口； 
{ 

FILE fp, tnp; 

char *s, tenpfn[64]; 

int c; 

if (-argo < 2) { 

puts( w llsage: feat <objf ile> <concatf ilel> . ..¥n"); 
exit(l); 

} 

ergv++; 

a = *argv++; 

if ((tip = fopen(nktnp(tenpfn), V，)) == NULL) { 
puts( w cannot make teup f ile¥n w ); 
exit(l); 

) 

for (； *ar«v; argv++) { 
/ if ((fp = fopen(*argv, "r")) != NULL) { 

while ((c - getc(fp)) != EOF) 

putc(tmp); 
fclose(fp); 

} 

} 

fclose(tmp); 
renaaie(teiipfn, s); 

) 
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第 6.欺 標^ ライブラリ 閱 数 リファレンス 



gets 



厂害式 I 

# include <stdio.h> 



char *gets、s， n) 
char *s ； 
int n ； 



厂 解説 1 

標準入力 (stdin) から 文字列 を 読み込みます. 文字列 は "¥n" を 終わりと して， s で 示される 領域 
に 読み込みます. また， 領域の サイズ を n によって 指定し ます. 文字列の 最後に は" ¥n "がっき， 
その後に 文字列の 終了 文字と して" ¥0" が 入ります. 読み込んで いる 最中に ファイルが エンド ォブ 
フ アイ ルに 達した 場合 は" ¥n" は 入らずに" ¥0" が 置かれます. fgets( ) は 最大で n_l 文字 を 読み込 
み 最後に" ¥0" を 置きます， 



戾り値 | 

標準入力 が エンド ォブ ファイルに 達した ときと， 何も 読み込まれなかった とき は NULL が 返 
されます. それ 以外の 時 は s が 返されます. 



參 照 I 

fgets( ), fputs( ), puts( ) 



厂 注意 1 

MSX-C の gets( ) は， 標準 的な C の gets( ) と は 動作が 異な ります. 標準 的な 動作の gets( ) は 
文字列の 最後に" ¥n "が 入 り ま せんが， MSX-C の g ets( ) は" ¥n "が 入 ります. 



例 



#inciude <stdio.h> 
char buf[2563; 

nainO 

{ 

FILE *fp; 

/* キーボードからの 入力 を ファイルに 保存す る tl 
If ((fp - fopen( w Beiao M , ，V)) == NULL) { 
Puts( M FiIe cannot nake¥n"); 
exit(l); 

} 

while (gets(buf, 256)) 
fputs(buf , fp); 
fclose(fp); 

} 
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inp 



厂會式 i 

# include <conio.h> 

char inp(port) 
unsigned port ； 

I 解説 I 

port で 示される I/O ポートから データ を 1 バイト 入力し ます. ポート 番号 は 0 から 255 ま での 
範囲で 指定し ます. 



戻り 傕 ] 

I/O ポートから 入力され た 1 バイトの データ を char 型と して 返します. 



「參 照 

outp( ) 



伊 J I 
^include <stdio.h> 

讕 ainO 
{ 

int U 
char knj[32]; 
/* 漢字 ROM の 銃み 込み */ 
for (i - 0; i < 32； 

knj[i] = inp(0xd9); 

) 
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第 6 章 標難 ライブラリ 閱数 リファレンス 



isalnum 



厂 書式 I 

# include < ctype.h > 

BOOL isalnum(c) 
char c ； 

I 解脱 I 

文字が アルファべ ッ ト または 数字 かどう か を 調べます. つまり， "a" から" z", "A" から "Z"， "0" 
か ら "9" の どれ かで あ るか を 調べます. 



戻り 値 ， 

文字が アルファべ ッ トか 数字で あったら TRUE を 返します， そうでなかったら FALSE を 返 
します. 



「 » 照 1 

isalpha( )， isdigit( ) 

I 注意 I 

この 関数 は マクロで すので， じに は 副作用 の ある もの は 指定で きません. 
こ の 関数 は Ver . 1 . 2 から 標準 ライブラリに 追加され まし た， 
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例 1 

# include <stdio.h> 

/* 指定され た 文字列 は 名前 （織 別 子） か？ */ 
BOOL isnane(s) 
char *s; 
{ 

if (!isalpha(«s)) 

return (FALSE); 

s++; 

while (Iisspace(«s» { 

if (!isatnun(«s» 

return (FALSE); 

s++; 

} 

return (TRUE); 

} 

nain(argc f argv) 
int argc; 
char *argv[]; 
{ 

char buf[256]; 
FILE *fp = stdin; 

if (~argc) 

if ((fp = fopen(argv[l] > "r")) NULL) { 
puts( w Fi!e not found¥n w ); 
exit(i); 

) 

while (fgets(buf, 256, fp)) { 
puts(buf); 
puts( w is "); 
if (tisnaae(buf)) 

puts( w not ")l 
puts( w identifier¥n"); 

} 

fclose(fp); 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



isalpha 



厂 書式 I 

# include < ctype.h > 



BOOL isalpha(c) 
char c ； 



r 解説 i 

文字が アルファべ ッ ト かどう か を 調べます. つまり， " a " から" z "， "A" から" Z" のどれ かで ある 
か を 調べます. 



戻り 值 I 

文字が アル ファ ベットで あったら TRUE を 返します. そうでなかったら FALSE を 返します. 



參 照 I 

is!ower( )， isupper( ) 



厂 洤— 意 一" | 

この 関数 は マクロで すので， c に は 副作用 の ある もの は 指定で きません. 



^include く stdio,h> 

麗 ainutrge, argv) 
int argc; 
char *ergv[]; 
{ 

if (—argc < 1) { 

putsCUsage: drvname <d:>¥n w )l 
exit(l); 

} 

if (tisalpha(argv[l][0]) n argv[l][l] 1= ，： ， M argv[l][2] != '¥0，） 
puts( w Argument oust be drive naae ，d"Vn" バ 
exit(l); 
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isatty 



厂害式 i 

# include < io.h> 

BOOL isatty (fd) 
FD fd ； 



r 解脱 「 

ファイル ハンドル fd が デバイス かどう か を 調べます. isatty() は コマンドの 動作 を， 入出力の 
対象が デ バイ スフ アイ ルか ディ スクフ アイ ル かで 変えたい 場合に 使用 します. 例え ば UNIX のべ 
ージ ごとに 表示す る フィルタ more では， 標準出力が デバイスの 場合に は キーの 入力 待ち をし ま 
すが， ファイルに リ ダイレク ト されで いる 場合に は 何も しない フィルタになります. 

I 戻り 値 | 

ファイル ハンドルが デバイス である 場合に は TRUE を 返します. ファイル であるか， ファイル 
ハンド ルが才 ープン されて いない 場合に は FALSE 力 《返されます. 



注 意 | 

こ の 関数 は Ver. 1 , 2 から 標準 ライブラリ に 追加され ま し た. 



_m 

^include <stdio.h> 

廳 ain() 
{ 

/* 標举 出力 は リダイレクトされ ている か？ */ 
if ( isatty (f i 1 eno(stdout) ) ) 

fputsCstdout is a device¥n w , stderr); 

else 

fputsCstdout is a fileW, stderr); 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



iscntrl 



I 書式 I 

include <s ctype.h > 

BOOL iscntrUc) 
char c ； 



解 脱 

文字が コント ロー ル 文字 か どうか を 調べます. （コードで は 0x20 未満 と 0x7f の 文字） 



戻り 値 



文字が コ ン ト ロール 文字で あつ た ら TRUE を 返します. そうでなかったら FALSE を 返し ま 
す. 



注 意 



この 関数 は マクロで すので， c に は 副作用 の ある もの は 指定で きません. 



例 



Kinciude <stdio,h> 

nainO 

{ 

int c; 
FILE *fp; 

/* ファイルの 内容 を コントロール 文字 を 含めて 表示 */ 
if ((fp = fopen( M data w , w rb")) == NULL) { 
puts ぐ' File not found¥n M )5 
exit(l); 

) 

while ((c = getc(fp)) != EOF) { 
if (c == 0x7f) 

puts (い?"）； 
else if (iscntrK(char)c)) { 
putclmK，"》 
putchar((char)(c - '0'))i 

} else 

putchar((char)c); 

} 

} 
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isdigit 



厂 書式 i 

# include <ctype.h> 



BOOL isdigit(c) 
char c ； 



厂 解脱， 

文字が 数字の 文字 (0 か ら 9) か どうか を 調べ ま す. 



厂 戻り 値 つ 

文字が 数字で あつ た ら TRUE を 返します. そうでなかったら FALSE を 返します. 



參 照 

isxdigit( ) 



注 窓 | 

この 関数 は マクロで すので， c に は 副作用の ある もの は 指定で きません. 



厂 俩 I 

Sinclude <stdio.h> 

匪 aiti(argc, argv) 
int argc; 
char *argv[]; 
{ 

int 1； 

char *p; 

if (--argc < 1) { 

puts( M Usage: atoi <nunber> . ..¥n w ); 

exit(l); 

} 

argv++; 

/* atoiO のよう な こと をして みる */ 
while (argc—) { 
i = 0； 
P = argv++ 
while (isdigit(*p)) 

i = I * 10 + *p++ - '0，； 
printf("Xd¥n"， i); 

} 

} 
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第 6 章 標， ライブラリ 関数 リファレンス 



iskanji 



厂害式 I 

# include < ctype.h > 

BOO し iskanji (c) 
char c ； 



厂 解脱 I 

文字が 漢字の 第 1 バイト かどう か を 調べます. （コードで は 0x81 から 0x9f， OxeO から Oxfc) 
I 戻り 値 | 

文字が 漢字の 第 1 バイ ト であ つたら TRUE を 返します. そう でな かつ た ら FALSE を 返し ま 
す. 



「豢照 | 

「3.5 漢字 処理の 方法」 
iskanji2( ) 

I 法 意 I 

この 関数 は マクロで すので， c に は 副作用の ある もの は 指定で きません. 漢字 かどう か は， 調べ 
ようと している 文字列の 先頭から すべての 文字に ついて 漢字 か， ANK か を 見なければ 正確に は 
判りません. 

この 関数 は Ver . 1 . 2 から 標準 ライブラリに 追加され ました. 
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例 I 

^include <stdio，h> 

/* 漢字 を 含んだ ディレクトリ 名から ディレクトリの 区切り を 見つける */ 
char «pathdelinit(s) 
char tal 
{ 

while (*s) { 

if (*s == 9 W) 

return (s); 
if (iskanji(*s)) 

s++ 

s++; 

} 

return (NULL); 

} 

腿 ditiCargc， argv) 
int argc! 
char *argv[] ； 
{ 

char *p; 

if (一 arse < 1) { 

PutsCUsage: pdlnt く pathW); 

exit(l); 

} 

argv++; 



p = *argv; 

while (p = pathdelinit(p)) { 
*P - ，W，； 
puts(*argv) ； 
*P++ = '¥¥'； 

) 

} 
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第 6 章 標準 ライブラリ^ 数 リファレンス 



iskanJiS 



厂害式 I 

ff include < ctype.h > 

BOO し iskanji2(c) 
char c ； 

I 解 K I 

文字が 漢字の 第 2 バイト かどう か を 調べます. （コードで は 0x40 から 0x7e， 0x80 から Oxfc) 
I 戻り 値 I 

文字が 漢字の 第 2 バイ ト であったら TRUE を 返します. そうでなかったら FALSE を 返し ま 
す， 



参照] 

「3.5 漢字 処理の 方法」 
iskanji( ) 



厂 注意 I 

この 関数 は マクロで すので， c に は 副作用の ある もの は 指定で きません. 漢字 かどう か は， 調べ 
ようと している 文字列の 先頭から すべての 文字に ついて 漢字 か, ANK か を 見なければ 正確に は 
判りません. 

この 関数 は Ver . 1 . 2 から 標準 ライブラリに 追加され ました. 
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例 I 

BetinUrgc* argv) 
int argc; 
char *argvC]; 
{ 

FILE *fp = stdin; 
int c; 
TINY status; 
char cold; 

if (—argc > 0) 

if ((fp = fopenCargvCl], "r")) == NULL) { 
putsCFIle not foumtfn"); 
exit(l); 

} 

status = 0； 

while ((c = fgetc(fp)) != EOF) { 
switch (.status) { 
case 0： 

if (iskanji(Cchar)c)) { 
status = I； 
cold = c; 

} else 

putchar(Cchar)c); 

break; 
case 1： 

status = 0； 

if (iskanji2((char)c)) 

printf( M Mc M , cold, c); 

printf( M X02x %02x n , (int)cold, c); 

break; 

} 

putcharC ')； 

} 

} 
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第 6 章 標略 ライブラリ 閔 数 リファレンス 



islower 



I 書式 I 

include < ctype.h > 

BOO し islower (c) 
char c ； 

I 解脱 I 

文字が 英小文字 か ど う か を 調べます. 



戾り値 1 

文字が 英小文字 であ つたら TRUE を 返します. そう でな か つたら FALSE を 返します. 



參 照 I 

isupper( ), tolower( ), toupper( ) 



洤 意 | 

この 関数 は マクロで すので， c に は 副作用 の ある もの は 指定で きません. 



_m ] 

ftinclude <stdio.h> 

nainO 
{ 

int c; 

A キーボードからの 入力で 小文字 だけ 出力す る */ 
while ((c = getcharO) 1= EOF) { 
if (islower((char)c)) 

putchar((char)c); 

} 

} 
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isspace 

「書式 i 

# include <ctype.h> 

BOOL isspace(c) 
char c ； 



解 説 1 

文字が スペース 文字 （スペース， タブ， ラインフィード， ホーム， ク リア， キヤ リジ リターン） 
かどう か を 調べます. （コードで は 0x20 と 0x09 から OxOd の 文字） 

I 戻り 値 | 

文字が スペース 文字で あ つたら TRUE を 返します. そうでなかったら FALSE を 返します. 



厂 注意"！ 

この 関数 は マクロ です ので， c に は 副作用の ある も の は 指定で きません, 



itinclude <stdio.h> 

/* スペース 以外の 文字まで スキップ する */ 
char 家 skipspuO 
char *p; 
i 

while (isspace(*p)) 
p++; 

return (p); 

} 

BdinO 

{ 

FILE *fp; 
char buf[256]; 

if ((fp = fopen( w head.c w , "r")) == NULL) { 
PUtsChead.c not f ound¥n w ) ； 
exit(l); 



while (fgetsCbuf, 268, fp)) 
puts(skipsp(buf)); 



第 6 章 標準 ライブラリ 関数 リファレンス 



isupper 



厂害式 I 

# include < ctype.h > 

BOO し isupper(c) 
char c ； 



I 解 一 脱 ] 

文字が 英 大文字 か どうか を 調べ ま す. 

1 戻り 値 | 

文字が 英 大文字で あ つたら TRUE を 返します. そう でな かつ た ら FALSE を 返します. 



參 照 | 

islower( ), to!ower( ), toupper リ 



注意つ 

この 関数 は マクロで すので， c に は 副作用 の ある もの は 指定で きません, 



_m ] 

^include <stdio.h> 

nainO 
{ 

int c; 

/* キーボードからの 入力で 大文字 だけ 表示す る 
while ((c = getcharO) != EOF) { 
if (isupper((char)c)) 

putchar((char)c); 

} 

} 
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isxdigit 



厂 書式 i 

# include <ctype.h> 

BOOL isxdigit(c) 
char c ； 

I 解脱 I 

文字が 16 進数の 文字 ("0" か ら "9"， "a" か ら "f "， " A" か ら "F") か どうか を 調べ ま す. 



厂 戻り 値 I 

文字が 16 進数の 文字であった ら TRUE を 返します. そう でなかった ら FALSE を 返します. 

I 参照 I 

isdigit( ) 

| 注意 1 

この 閼数は マクロで すので， c に は 副作用 の ある もの は 指定で きません. 
こ の 関数 は Ver . 1 .2 か ら 標準ラ ィ ブラ リ に 追 力 n さ れま した. 
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第 6 章 標準 ライブラリ 関数 リファレンス 



#include 



<stdio.h : 



颸 ainCargc, argv) 
int argc; 



char *argv[]; 
{ 

int i; 
char c, *p; 

if (—argc < 1) { 

puts( M Usage: hextodec <hexadecnal> ...¥n w ); 
exit(l); 

} 

argv++; 

/* 1 6 進数 版 atoiO をす る */ 




P = *argv; 
i = 0； 

while (isxdigit(*p)) { 
c = *p; 

if (isdigit(c)) 
c 一 = ,0 



o = toupper(c) - ，A， + 10； 



i = i * 16 + c; 



printfCXd ", i); 



putcharC^fn*); 
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kbhit 



[書式 I 

# include <conio.h> 
BOO し kbhit( ) 
I 解説 I 

キー ボー ドが 押された かどう か を 調べます. この 関数 は 標準入力の リダイレクトと は 関係な く ， 
キーボード バッファ の 状態 を 返します. 

I 戾リ値 I 

キー ボー ドバッ フ ァ に 文字が ある 場合に は TRUE を 返します. ない 場合に は FALSE を 返 し 
ます. 

I 注意 I 

標準入力が フ アイ ルに リダイレクトされ てい る 場合に は， 1 度 TRUE になる と 標準入力 か ら い 
くら 文字 を 受け取っても FALSE に はなり ません. open() で" con" を オープンし， reacl() すれば 
キーボードから 入力され た 文字 は 受け取れます， 



_m ] 

<linclude <stdio.h> 
char buf[256]; 

/* キ 一ボード バッファ もク リアす る */ 

kilLbufO 

{ 

while (kbhitO) /* keyboard buffer clear */ 

getchO; 

} 

塱 ainO 
{ 

unsigned i; 
for (〖 - 0; i < 65535 

kilLbufO; 
gets(buf, 256)； 
puts(buf); 

} 



/* push any key while waiting here */ 
/* kill keyboard buffer %l 
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第 6$ 標準 ライブラリ 関数 リファレンス 



longjmp 



「害 式 I 

F include <setjmp.h> 

VOID longjmp(env, val) 
jmo buf env ； 
int val ； 

I 解脱 I 

longjmp( ) は， setjmp( ) で 設定 された jnip— buf 型の バッファ eiw を パラメータ とする ことで， 
関数 を 越えて ジャンプし， env を 設定した setjmp( ) の 次 (関数から 値が 返って く ると ころ） に 戻る 
ことができます. また そのと きに val で seUmp( ) の 戻り 値 を 渡す ことができます. た だ し， val は 
0 以外の 値で なければ なりません. 



厂 戻り 値 I 

ありません. 

1 参照 I 

setjmp( ) 

1 注意 I 

val が 0 の 時に は 値が 変更され ます. 
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_m i 

^include <stdio.h> 
j 鼸に buf 膽 bun 

gofuncO 
{ 

int err - 0; /* エラー フラグの ク リア */ 



if (err) /* エラーが 発生した か？ */ 

longjip(ttbuf, err); /* エラーが 起きたら 強制的に 戻る */ 

} 

■ain() 

{ 

static int i; 

if (i = setjnp(abuf)) { 

/* longj 隠 p() から 戻って きた */ 

r>r int f ("Return froi longjnpO with code Xd¥n M , 1)； 
} else { /t 最初の setj»p() */ 

printf。8eU 騸 r>6 is executed¥n w )l 

gofuncO; 

} 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



max 



| 害 式 I 

# include <stdlib.h> 

int maxvx, y) 
int x, y ； 



厂 解脱 I 

整数 x と y を 比較して， 小さ く ない 方 を 返します. max() はふた つの 数値の 大きい 方 を 選びた 
いとき に 使います. 



戻り 値 I 

x と y で 小さくない 方の 数値 を 返します. 値が 等しい 時 は その 値 を 返します. 



「参照 I 

min( ) 

1 例 I 

^include <stdio.h> 

nainO 

{ 

A それぞれ 数値の 大きい 方 を 表示 5, 2, 7 が 表示され る */ 
printfCXd %d XdVn\ iax(U 5), 疆 ax (- 3, 2), 重 ax(7, 7))； 
} 
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memcpy 



厂害 式] 

# include <memory.h> 

VOID memcpy (dest, source, length) 
char * dest, * source ； 
size t length ； 



厂 解脱 I 

メモリの source で 示す 位置から， length の 長さ だけ， dest で 示す 位置に 内容 を コピーし ます, 
strcpy() などの 文字列 操作 関数との 違い は， "¥0" を 操作の 終了 マークと して 使わない 点です， 転 
送 元 (source) と 転送先 （des りの 領域が 重なって いる ときに も， 内容が 壊されな いよ うに 転送し ま 
す. movmem() と は パラメータの 順番が 違う だけで， 動作 は 同じです. 



厂 戻り 值 I 

ありません. 

I 参照 I 

movmerru ) 

I 注意 I 

MSX- DOS などの ワーク エリア を 破壊し ないように， 注意して 下さい, 
この 関数 は Ver,1.2 から 標準 ライ ブラ リ に 追加され ま した. 



_m | 

#inciude <stdio.h> 

#define CMDLIN (char *)0x80 

char buf[128]; 

nainO 

{ 

/* コマンド ラインの コ ビー を 作る */ 

隱 e 轚 cpy(buf, CMDLIN, sizeof(buf)); 
buf[(int)buf[0]+l] = ，¥0，； 
puts ひ uf + 1)； 

} 
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第 6 章 標準 ライブラリ 1对 数 リファレンス 



memset 



厂 書式 I 

# include <memory.h> 

VOID memset(dest, byte, length; 
char *dest, byte ； 
size t length ； 



厂 解脱 1 

dest で 示される メモリ か ら length の 長さ だけ， byte の 値で 埋め ま す. length の 単位 は バイ ト で 
す， setmem( ) と は バラ メータ の 順番が 違う だけで 動作 は 同 じです， 

I 戻り 値 | 

ありません. 



r 参照 I 

setmemv ) 
I 注意 I 

MSX-DOS などの ワーク エリア を 破壊し ないように， 注意して 下さい. 
この 関数 は Ver. 1.2 から 標準 ライ ブラ リ に 追 力 n されました. 
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_M I 

(include <stdio.h> 
int count [10]； 

nainO 

{ 

int c; 

int count [10]； 

int other; 

/* 配列 buf を 0 で 初期化す る */ 

nenset (count, (char)O, sizeof (count)); 
other = 0； 

while ((c = getcharO) 1= EOF) { 
if (isdigit((char)c)) 

countCc 一 '0'3++； 

else 

other++; 

} 

for (c = 0； c < 10； C++) 

printfCXd , Xd , (s)¥n w , count [c], c); 

} 
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第 6^ 標^ ライブラリ 関数 リファレンス 




厂 書式 I 

# include <stdlib.h> 

int min(x, y) 
int x， y ； 



厂 解脱 I 

整数 x と y の 数値 を 比較して， 大きくない 方 を 返します. niin() はふた つの 数値の 小さい 方 を 
選びたい ときに 使います. 

I 戻り 値 I 

x と y で 大き く ない 方の 数値 を 返します. 値が 等しい 時 は その 値 を 返します. 



# 照 

max( ) 



例 



^include <staio.h> 

讓 ain() 
{ 

/* それぞれ 小さい 方 を 表示し ます 1, -3, 7 が 表示され る */ 
printf("Xd Xd Xd¥n", 釅 in(l, 6), nin(-3, 2), 隱 in(7, 7))； 
} 
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mkdir 



厂害式 i 

# include <direct.h> 

STATUS mkdir(path) 
char *path ； 

I 解脱 I 

サブ ディ レク ト リ を 作成し ます， path は ルート ディ レク ト リ からの 指定で も， カレント ディ レ 
ク ト リ からの 指定で もで きます. ドライブ を path 中に 指定す ると その ドライブに サブ ディ レク 
ト リが 作成され ます. （[d ： ][¥]path の 形で 指定し ます.） 

I 戻り 値 I 

サブ ディレクトリ が 作成 さ れた 場合に は 0K を， 失敗 し た 場合に は ERROR を 返します， 



# 照 | 

chair リ, rmdir( ), getcwd( ) 



注意， 

mkdir() では 存在し ない サブ ディ レク ト リの 下に サブ ディ レク ト リ を 作成す る こと はでき ま 
せん. 作成したい サブ ディ レク ト リの親 ディ レクト リ まで を mkdir() によって 作成して 下さい. 
また， 同じ 名前の ファイル 力 《存在した ときに も， 作成で きません. 

この 関数 は Ver . 1 . 2 から 標準 ライブラリに 追加され ました. 



例 | 
# include <stdio.h> 

nainO 

{ 

/* サブ ディレクトリ ¥bin を 作る */ 

if (chdir( w *¥bin w ) == ERROR) { 

putsCMaking ，¥¥bin， Subdi rectory. ¥n M ); 
nkdir ("お bin"); 

} 

A Now subdirectory ，¥bin， must exist */ 
} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



movmem 



厂害式 I 

f include く memory. h> 

VOID movmem(source, dest, length) 
char *dest, * source ； 
size t length ； 



[ 解 ^ ] 

メモリの source で 示す 位置から， length の 長さ だけ， dest で 示す 位置に 内容 を コピーし ます. 
strcpyO などの 文字列 操作 関数との 違い は， "¥0" を 操作の 終了 マークと して 使わない 点です. 転 
送 元 (source) と 転送先 (dest) の 領域が 重なって いる ときに も， 内容が 壊されな いよう に 転送し ま 
す. memcpy( ) と は パラメ一 タの 順番が 違う だけで， 動作 は 同じです. 

I 戻り 値 I 

あり ません. 



「 » 照 I 

memcpy( ) 

I 注意 I 

MSX-DOS などの ワーク エリア を 破壊し ないように， 注意して 下さい. 



_m | 

^include <stdio.h> 

#define CMDL1N (char *)0x80 

char buf[128]; 

nainO 

{ 

/* コマンド ラインの コビ一 を 作る */ 

■ovaeinCCMDLIN, buf, sizeof (buf)); 
buf[(int)buf[0]+l] = '¥0，； 
puts(buf + 1)； 

} 
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open 



i 害 式 i 

# include <io.h> 

FD open (filename, mode) 
char * filename ； 
int mode ； 

I 解脱 I 

filename で 示された ファイル を オープン しま す. filename に は ドライブ， パス 名 を 含める こと 
がで きます. オープン する ことで 以後 は その ファイルへの 読み書き は 戻り 値の ファイル ハンドル 
で 行える ようになります. mode に は オープンしょう としてい る ファイルの オープン モード を 指 
定 します. ファイルの オープン モードに は 次の ような 値が あります. 

O 一 RDONLY 読み込み のみ 

ファイルがない とき は エラーになります. 
0_WRONLY 書き込み のみ 

ファイルが すでにあるなら， writeO したと き 上書き されます. 
O.RDWR 読み書き 両方 

戻り 値 | 

フ アイ ル がない など フ ァ ィ ルの オープンに 失敗す る と ERROR を 返します， そう でない とき は 
ファイル ハンドル を 返します. 

I 参照 1 

closeC ), creat()， read( ), write ( ) 



注 意 I 

open( ) は 低水準 入出力 関数です. 
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第 6《ii 標準 ライブラリ 関数 リファレンス 



I 伊】 I 

^include <stdio.h> 

static char "StrC] = "test data"; 

顧 ainO 
{ 

FD fd; 

1% ファイル を 書き込み モードで オープン する */ 

if ((fd = open( w openfile.dat M , OJRONLY)) == ERROR) { 
PUtsCTHe cannot open¥n w ); 
exit(l); 

} 

write(fd, str» strlen(str)); 
close(fd); 

} 
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outp 



厂害式 I 

# include <conio.h> 

VOID outp(port ( val) 
unsigned port ； 
char val ； 



[ 解 _fSt j 

port で 示される I/O ポー ト に データ val， 1 バイト を 出力し ます. ポート 番号 は 0 から 255 まで 
の 範囲で 指定し ます. 

I 戻り 値 

ありません. 



「参照， 

inp( ) 



― 》i 息 | 

出力す る ポートに よって は， MSX の 誤動作の 原因に なり ますので 注意して 下さ い. 



厂 例 

♦include <stdio.h> 

■ain() 

{ 

int i; 
char knj[32]; 
/* 漠宇 ROM パターン を 読み込む 
outp(0xd8, 0)； 
outp(0xd9, 1)； 
for (i = 0； i < 32； 

knjCi] = inp(0xd9); 

} 
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第 6 草 標準 ライブラリ 関数 リファレンス 

printf 



厂害式 I 

include <stdio.h> 

STATUS printf(format[, arg1 , arg2, ...]) 
char * format ； 

I 解脱 I 

prhitf() は， 書式 付きの 変換 を 行ない， その 出力 を 標準出力 (stdout) に 書き出します. 引数 
argl, arg2, …は format で 示される 制御 文字列に よ つ て 変換され る 値 や， 文字列への ポィ ンタを 
渡します. 制御 文字列 は， 変換され ずに そのまま 出力され る 通常の 文字と， 次の 形式の 変換 指定 
からなります. 

% [-] [[0]w][.n]c 

変換 指定 は バー セント 記号 (％) で 始まり， 何番! ^に 現れた かによ つて argl， arg2 などの 値との 
対応が 取られます. マイナス 記号 (-） は， この フィールドが 左 寄せされ る こと を 示します (通常 は 
右 寄せ）. "w" は， フィールドの 最低限の 幅 を 10 進数で 示し， w が 0 で 始まって いると， この フィ 
一 ルドの 余白 は， スペースの 代わりに" 0" で 埋められます. ".n" は， 文字列 変換 (％s) の 時の み 有効 
で， 文字列の うち， 出力され る 最大の 文字 数 を 10 進数で 指定し ます. 文字 c は， 次のう ちの いず 
れ かの 変換 文字です. 

d 対応す る 引数 を 符号 付き 10 進数と して 衷示 
u 対応す る 引数 を 符号な し 10 進数と して 表示 
o 対応す る 引数 を 符号な し 8 進数と して 表示 
x 対応す る 引数 を 符号な し 16 進数と して 表示 
c 対応す る 引数 を 文字コード として 文字 を 表示 

S 対応す る 引数 を 文字列への ポインタ として 文字列 を 表示 

上に 示された 変換 文字で ない もの は， そのまま 出力され ます. また， "％% "という 文字 シーケ 
ンス によって， 1 つの パーセント 記号" ％ "を 出力す る ことができます. 



戻り 値 1 

出力 中に エラ 一がな ければ OK が 返 されます. そうでなければ ERROR が 返されます. 



# 照 I 

fprintf( )， sprintf( ) 
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E 》 主意 I 

char 型の 値 を" ％d"， "％x", "%o" によって 表示す る 場合に は， int 型に キャス トし たもの を 引 
数と して 渡して 下さい. これ は， 呼び出し 側 は char 型 (1 バイ ト値） で 渡します が， printf() は int 
型で 渡 された とする ために， int 型の 上位 パイ ト が 不定な 値 による 表示 を 避 ける ためです. char 型 
だけでなく BOOL 型， STATUS 型， TINY 型の 場合 も 同じ様にして 下さい. "％c "で 表示す る 際 
は 問題ありません. 

printf("Xd X02x¥n w , (int)c, (int), A'); 



printf() は 可変 パラメータ 関数な ので， 次の 宣言が あらかじめ 必要です 



STATUS printfC); 

こ の 宣言 は， ヘッダ ファイル stdio.h に 含まれて います. 
printf ( ) は UNIX の 標準 C の サブセット になって います. 

I 例 I 

Kinclude <stdio.h> 
int val = 1234； 
char c = 'A'; 

static char str[] = "printf test string"; 

nainO 
{ 

/* 10 進， 18 進， 8 進で 数値の 表示と 文字， 文字列 を 表示す る */ 

printf ("decimal Xd¥nhexadeciial X04x¥noctal X06o w , val, val, val); 
printf ("char ^c'Vnstring ，お '¥n"， c, str); 

} 
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第 6 章 標準 ライブラリ 1« 数 リファレンス 



pute, putchar 



厂害式 i 

# include < stdio.h > 

STATUS putc(c, fp) 
char c ； 
FILE *fp ； 

STATUS putchar(c) 
char c ； 



厂 解脱 I 

putc( ) は fp で 示される ファイルに 1 文字 出力 します. putchar( ) は 標準出力 (stdout) に 1 文字 
出力し ます. 文字 c が" ¥n "でフ ァ ィ ルが テキス トモ一 ドの 時に は" ¥r "と" ¥n "の 2 文字に して 出 
力し， ファイルが 行 バッファリングなら， ノ s ッファ を フラッシュ します. 



戻り 僂 I 

1 文字 出力で きたら 0K を 返します. そう でな かつ た ら ERROR を 返します. 



厂參照 1 

fsetbin( ), fsettext( ) 

I 注意 I 

渡す 文字 は char 型な ので getc( ) などの int 型で 返された もの を 出力す る 場合に は 必ず char 
型に キャス ト して 下さい. 
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I w I 

{(include <stdio,h> 

nainO 
{ 

int c; 
FILE *fp; 

/* キーボードの 入力 を 標準出力と ファイルに 出力す る */ 
if ((fp = fopen("f ile", ，V，)) == NULL) { 
puts( M File cannot 塑 ake¥n w " 
exit(l); 

} 

while ((c = getcharO) != EOF) { 

putchar((char)c); /* 標寧 出力に 出力 */ 
putc((char)c, fp); /* ファイルに 出力 */ 

} 

} 
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第 6$ 標準 ライブラリ 関数 リファレンス 



putenv 



厂害式 1 

# include <stdlib.h> 

STATUS putenv^ en v) 卜 set environment */ 

char *env ； /* < varname > = < value > */ 

I 解脱 I 

MSX-DOS2 の 環境 変数の 値 を 設定し ます. パラメータの 文字列 env は 「環境 変数 名-値 j の 形 
である 必要が あります. 値が 省略され たと き は その 環境 変数 は 消去され ます. 設定した 環境の 値 
は getenv() で 獲得す る ことができます. また， 実行中の コマンドが 終了しても 環境の 値 は 残って 
いるので， SET コマンド で 確認した り 別の コマ ン ド で 使用す る ことができます. 



戻り 値 | 

環境が 正 しく 設定で きたと き は 0K を 返します. そうでな いとき は ERROR を 返します. 



「参照 I 

get env ( ) 

I 注意 I 

バラ メータ env の 示す 文字列に イコール 記号" == "がない と 環境 変数 は 設定で きません. 
この 関数 は Ver. 1.2 から 標準 ライ ブラ リ に 追加され ました. 

I 例 I 

^include <stdio.h> 

aainO 

{ 

A 環境 を 設定 後， 獲得して 値 を 検査す る 

if (putenv( w MYENVIRON=value of kankyou") == ERROR) 

puts( M putenv Failed" J 
if(strcnp(getenv("MYENVlRON w ), "value of kankyou M )) 

puts(，，Failed"); 

else 

puts( w 0D; 

} 



21 1 



puts 



厂害式 I 

# include <stdio.h> 

STATUS puts(s) 
char *s ； 



[解お i 

標準出力 (stdout) に 文字列 s を 出力し ます. 出力に 対して" ¥n "をつ けたり はしません. 文字列 
s は ヌル 文字で 終って いなければ なりません. また， ヌル 文字 は 出力され ません. 文字列 中に，， ¥n" 
があった 場合に は テキス ト モードで あれば "¥r" + "¥n" にして 出力し ます. 

I 戻り 値 I 

出力 中に エラー が 発生 し た 場合 に は ERROR が 返されます. そ れ 以外で あ つたと き は 0K が 返 
されます. 

I 参照 I 

fgets( )， fputs( )， gets( ) 



厂洤意 I 

MSX-C の puts( ) は， 標準 的な C の puts( ) と は 動作が 異な ります. 標準 的な 動作の puts( ) は 
文字列 を 出力した 後 "¥n" を 出力 し ま す 力、 MSX-C の puts( ) は 出力 しません. 

I 伊】 I 

itinclude <stdio.h> 
char buf[256]; 

nainO 

{ 

FILE *fp; ― 

/* ファイル newgane.dat の 内容 を 表示す る */ 

if ((fp = fopen( w newgame.dat M . "r")) == NULL) { 

puts( w File not found¥n w ); 

exit(I); 

) 

while (fgets(buf f 256, fp)) 

puts(buf, fp); 
fclose(fp); 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



gsori 

I 書式 I 

# include <stdlib.h> 

VOID qsort(base, nel, width, compar) 
char *base ； 
unsigned nel, width ； 
int (* compar) ( ) ； 



厂 解脱 I 

データ を 昇順に 並べ 換えます. base は データの先頭 アドレス， nel は ソートす る データの 個数， 
width はデー タ の 各 要素の 大 きさ を バイト 数で 表 し た も のです. 

compar は， 2 つの ポインタ （x と y) を 引数と して， 次に 示す よ う な int 型の 値 を 返す 関数への ポ 
ィ ンタ です. 

正 *x 〉 *y 
0 *x = *y 
負 *x < *y 



戻り 值 1 

ありません. 
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例 I 

# include <stdio,h> 

static char *device[8] = ("screen", "keyboard", "joystick 

"floppy disk", "hard disk", M mouse M , 
"cassette", "RS-232C"}; 

int coiapare(x, y) 
char **x, **y; 
{ 

return (strcinp(*x, *y)); 

} 

/* 文字列の 配列 device を ソート 前と ソート 後 を 表示す る */ 

nain() 

{ 

int i; 

for (i = 0； i < 8； i++) 

printf("fe¥n", deviceCi]); 
puts( M Sorting..¥n M ); 

qsort(device, 8, sizeof(char *), compare); 
for (i = 0； i < 8； 

printf(，，Xs¥n", deviceCi]); 

} 
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標^ ライブラリ 関数 リファレンス 



read 



書 式 I 

# include <io.h> 

int read(fd t buf, bytes) 

FD fd ； 

char *buf ； 

size t bytes ； 



解 脱 I 

ファイル ハンドル fd で 示された ファイルから， データ を 読み込みます， 読み込む データの 長さ 
は bytes で 指定 し， 読み込んだ デー タ は buf か ら の 領域に 格納され ます. 

I 戻り 値 I 

ファイル ハンドルが オープンされ ていない もの， オープンした 時の モードが ライ ト モードで あ 
る， ファイルが エンド ォブ ファイルに 達して いるな どの どれ かで あったら， 0 力ぶ 返されます. そう 
でなかったら 実際に 読み込まれた バイ ト 数が 返されます. ですから， bytes よ り 小さい 値で ある 可 
能 性 もあります. 

I 参照 I 

close( ), creat( ), open( ), write ( ) 



注 意 1 

read( ) は 低水準 入出力 関数です. 



_M | 

お include <stdio.h> 
char buf [1024]； 

■ain() 

{ 

FD fd; 

/* ファイル readtest.dat を 1024 バイ ト ごとに エンド 才プ ファイルまで 読む */ 
if ((fd = open( M readtest.dat w . O.RDONLY)) == ERROR) { 
puts( w File not found¥n M ); 
exit(l); 

} 

while (read(fd, buf, sizeof (buf))) 

Puts( M Not E0F¥n M ); 
puts("Now E0F¥n M ); 
close(fd); 

} 
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rename 



i 害 式 i 

# include < io.h > 

STATUS rename(oldname, newname) 
char *oldname, * newname ； 

I 解脱 I 

oldname で 示された ファイルの 名前 を newname に 変更し ます. oldname で ドライブ， パス 名 
を 指定で きます が， newname に は 指定しても 無視され， ベース ネーム だけ 使われます. oldname 
に ワイルド カード を 指定 したり， フ アイ ルの 移動 はでき ません. 



戻り 值 1 

ファイル 名 の 変更が で き れば 0K を 返し， できな ければ ERROR を 返します. 



m 1 

K include <stdio,h> 

nainQ 

{ 

/* ファイル cf,coa を cfvl20.con に 名前 を 変更す る */ 
r enaie("¥Vb i nif¥cf • com" , M cfvl20 • cob") ； 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



rmdir 



害 式 



# include <direct.h> 

STATUS rmdir(path) 
char *path ； 



I 解 脱 I 

サブ ディ レク ト リを 削除し ます. path は ルート ディ レク ト リ からの 指定で も， カレント ディ レ 
ク ト リ からの 指定で もで きます. ドライブ を path 中に 指定す ると その ドライブの サブ ディ レク 
トリが 削除され ます. （[d:][¥]path の 形で 指定し ます.） しかし， 削除しょう とする ディ レクト 
リに ファイル や ディ レク ト リ があった 場合に は， 削除す る こと はでき ません. 



戻り 值 | 

サブ ディ レク 卜 リが 削除され た 場合に は 0K を， 失敗した 場合に は ERROR を 返します. 



I 参照 I 

chdir 、ク， mkdirv ；, getcwd( ) 



注 意 | 

この 関数 は Ver. 1.2 から 標準 ライ ブラ リ に 追加され ました. 



例 



{(include <stdio.h> 

nain() 
{ 

/* サブ ディレクトリ ¥bin を 削除す る */ 
if (ndir( w V¥bin w ) == ERROR) { 

puts("Erase all files in ，SMfbin， Subdirectory. Vn"); 

unlink (，，き 牝 iirf*.*"); 

if (rmdir("¥¥bin，，） == ERROR) 

puts( M, ¥¥bin' has Subdirectory. Cannot remove! l¥n M ) I 

} 

} 
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rsvstk 



i 害 式 i 

# include <malloc.h> 

VOID rsvstk(n) 
size t n ； 

I 解脱 I 

スタック 領域と して n バイ 卜 確保し ます. ここでい う スタック 領域と は sbrk() で 領域 を 確保 
する 時の 残りの スタックの ための 大きさ を 表します. スタック 全体の 大きさで はない ので 注意し 
て 下さい. 初期値と して は 1000 バイ ト 確保され ています. 詳しく は 「4.3.3 メモリ 管理 関数」 
を 参照して 下さい. 

I 戾り値 | 

戻り 値はありません， 



r 参照， 

allocO, freeO, sbrk( ) 
I 注意 I 

スタック 領域の 大きさ は ひとつ の 領域で 管理 している ので， メイン プロ ダラ ム 以外で 変更す る 
場合 は 注意して 下さい. 



_m | 

{(include <stdio.h> 

bigaryO 
{ 

char buf[1000]; 



} 

nainO 

/* 大きな 配列 を 使用す るた めに スタ プク 領域 を 大きく 確保す る * ゾ 
rsvstk(2500;; 

bigaryO; 一 
rsvstk(lOOO); /* 元に 戻す */ 

} 
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sbrk 



厂畲式 I 

# include <malloc.h> 

char *sbrk(n) 
size t n ； 



[解脱 I 

メモリ を n バイ ト 割り当てます. sbrk() は 低水準 メモリ 管理 関数です. 割り当てられた 領域 は 
解放す る こと はでき ません ので， 領域 を プログラムで 最後まで 使用 するとき 使う といいで しょう. 
高水準 メ モ リ 管理 関数 alloc( ) と の 共用 は 可能です が， 連続 し た 領域が 取れに くくなる ので， alloc 
() や free() を 多用して いる プログラム では 効率が 下がって しまいます. 詳しく は 「4. 3. 3 メモリ 
管理 関数」 を 参照して 下さい. 



厂 戻り 値 I 

領域が 割り当てられた 場合に は， その 領域の 先頭への ポインタが 返されます. メモリが 足りな 
いとき は ERROR が 返されます. 

I 参照 I 

alloc り, free()， rsvstk( ) 



_m ] 

^include <stdio.h> 

nainO 

{ 

char *p; 
/* バッファ 用の 領域 を 確保 */ 

if ((p - sbrk(128)) != ERROR) 

setvbuf(stdin, p, .IOFBF, 128)； 

} 
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scanf 



i 書式 i 

# include <stdio.h> 

int scanf (format 匸, argl , arg2 f ...]) 
char * format ； 



厂 解脱 I 

scanf ( ) は 標準入力 (stdin) から 書式 変換 付 き の 入力 を 行ない ま す. format で 与える 制御 文字列 
は， 変換 指定 文字と 入力 ストリームと 一致すべき 文字の 二者から なります. 引数 argl， arg2，... 
は， 変換の 結果 得られた 値 を 格納す るた めの 変数への ポィ ンタ でなければ なりません. 

変換 指定の フォー マツ トは 次の 通りです. 

%[*]c 

変換 指定 は パーセント 記号 (％) で 始ま り ます. アスタリスク （り を パーセント 記号の 直後に お 
くこと によって， 得られた 値 を 代入せ ずに 捨てる こと を 指定で きます. 文字 c は 書式 指定 子で， 
次のう ちの いずれ かです. 力 ッコの 中 は 通常 格納され る 変数の 型です. 

d 入力 文字列 を 符号つ き 10 進数と して 変数に 代入し ます. （int 型） 

u 入力 文字列 を 符号な し 10 進数と して 変数に 代入し ます. （unsigned 型） 

o 入力 文字列 を 符号な し 8 進数と して 変数に 代入し ます. （unsigned 型） 

x 入力 文字列 を 符号な し 16 進数と して 変数に 代入し ます. （unsigned 型） 

c 入力 文字 を 1 文字 そのまま 変数に 代入し ます. （char 型） 

s 入力 文字列 を スペース などの 区切り 文字まで を 代入し ます. （char 型の 領域） 

数値 を 代入す る ときには， 入力 文字列に 数値 を 表す 文字 以外の 文字まで を 数値と して 代入し ま 
す. つまり， ，，％d '，で 符号つ きの 10 進数 を 代入す ると き は (） から 9 以外の 文字が 来る まで 10 進数 
として 見ます. また， 数値の オーバーフロー は 無視され ます. 

1 戻り 値 | 

scanfO は， 実際に 代入され た 項目 数 を 値と して 返します， 戻り 値が 1 で， 変数への ポインタ を 
3 個 パラメータに 指定したら， 2 個 目 以降 は 値が 代入され ていない ことになります. また， 標準 入 
力が ヱ ン ドォブ ファイル になつ た 時に は 値 EOF が 返 されます. 
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參 照 

fscanf( )， sscan れ ) 



[注意 1 

"% c "で 文字 を 代入す る とき は ライン フィー ド 文字 "¥n，， が 代入され て しまう こと もあります の 
で， 変換 文字の 指定に は 注意して 下さい. scanf() は 可変 パラメータ 関数な ので， 次の 宣言が あら 
かじめ 必要です. 

int scanf(.); 



この 宣言 は， ヘッダ ファイル stdio.h に 含まれて います. 
scanf( ) は UNIX の 標準 C の サブセット になって いま す, 



厂 例 I 

{^include <stdio.h> 
char buf[100]; 

顧 ainO 
{ 

int val, ni 
char c 

/* キーボードから 10 進数， 文字， 文字列 を 入力す る */ 
n = scanf( n Xd Xc Xs M , &val, &c, buf); 
printf ぐ , !!! d Batched decimal )l!d:char 'Xc*: string H' 
n, va!, c, buf) 

) 
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sensebrk 



厂害式 i 

# include <conio.h> 
VOID sensebrk( ) 
I 解脱 I 

ブレイク チェック をし ます. この 関数 を 実行中 に Ctrl + C または Ctrl + STOP が 押 されて いる 
と コマンド レベルに 戻ります, -sensebrk( ) 以外の 関数で もキ一 ボー ドゃ 画面に 入出力す る 関数で 
は， Ctrl+C ま た は Ctrl + STOl) で コマンド レベルに 戻 ります. 



戻り 値 I 

戻り 値 はあり ません 

注 意 | 

Ctrl + C, Ctrl + STOP で プログラム を 中止した 場合に は， 高水準 入出力 バッファ は フラッシュ 
されません. 
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例 I 

^include <stdio.h> 
char bufCiOO]; 
int ary[1000]; 

1% 整数の バブル ソート をす る. 途中で Ctrl+C で 止められる */ 

VOID bubble(array, n) 

int arrayu; 

int n; 

{ 

int top; 

for (i = 0； i < n - 1； i++) 

for (j = t + 1； j < n; j++) { 

sensebrkO; A break check */ 

if (arrayCi] > array [j]) { 
tntp = arrayCi]; 
arrayCi] = array[j]; 
arrayCj] = top; 

} 

} 

} 

nainO 

{ 

int i， n = 0; 

while (gets(buf. 100)) I 

ary[n++] = atoi(buf); 

) 

for (i = 0； i < n; i++) 

P rintf( M %6dXs M , ary[i], ((i X 5 == 4) ? In" ： ，， ")〉; 
buble(ary Y n); 
for (i = 0； i < n; 

printf("X6dfe", ary[a ((i X 5 == 4) ? w ¥n M ： " ")); 

} 
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setbuf 



厂害式 i 

# include <stdio.h> 

VOID setbuf(fp, buf) 
FILE *fp ； 

char *buf ； /* points allocated buffer(size BUFSIZ) */ 



厂 解説 1 

ファイルの バッファ を 設定し ます， setbuf () では バッファリングし ないか， フル バッファ リン 
グ をす るの 設定し かで きません. 細かい 設定が 必要な とき は setvbuf() を 使って 下さい. 

buf に は バッファへの ポインタ を 指定し ます. その バッファの サイズ は BUFSIZ であ る 必要が 
あります. buf が NULL の ときには バッファ リ ング をし ません (バッファ リ ング なし）, 
buf == NULL の 時 は 

setvbuf(fp f NULL, JONBF, 1)； 
buf != NULL の 時 は 

setvbuf(fp, buf, JOFBF, BUFSIZ); 
の 動作 をし ます， 



厂 展り値 I 

ありません. 

I 参照 I 

「4.3.1 B) 高水準 入出力 関数の バッファリング」 
setvbufv ) 

I 注意 I 

setbufO は fopen( ) で ファイル を オープン してから， データの 入出力 を 一切して いないと きに 
のみ 実行で きます. 

この 関数 は Ver. 1.2 から 標準 ライブラリに 追加され ました. 
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例 



ft include <staio.h> 

nainO 

{ 

FILE *fp; 
/* ファイル を パプ ファ リングな しで 使う */ 

if ((fp = fopen("test，，， V)) == NULL) { 

PUts( w File cannot nakeifn"); 

exit(l); 

} 

setbuf(fp. NULL) /* バッファ リ ン グを しない */ 

} 
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setjmp 



i 書式 i 

# include <setjmp.h> 

int setjmp(env) 
jmp buf env ； 



し 解脱 I 

setjmp( ) は longjmp( ) と 組み合わせて 使われます. setjmp( ) は 現在の ス タック ポインタ 等 を 
env に 設定 します. そ の 後 longjmp( ) では この env を 使って 呼び出す と setjmp( ) で 設定 し た 値 
を 元に 戻し， setjm P () 直後に 関数 を 越えて ジャンプ できます. これ は 関数の 深い ネスト 中に エラ 
一が 発生して， 上位の ルーチンに 直接 制御 を 戻す ために 使う と 有効でしょう. 



厂 戾り値 1 

現在の 状態 を 退避した とき は 0 を 返します. kmgjmp( ) 関数から 戻つ てきた ときには longjmp 
() の 第 2 パラメータの 数値 を 返します. この 数値に よって 上位の ルーチン はどうい つた 原因で 
setjmp( ) から 戻って きたの か を 知る ことができます. 

I 参照 I 

longjmp( ) 

I 注意 1 

setjmp() を 使用して いる 関数で， 変数が レジスタに 割り当てられ ている 場合， longjmp() で 戻 
つてき たと き 変数の 値 は 保存 されて いません. 
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例 1 

^include <stdio.h> 
jnp.buf nbuf ； 

gofuncO 
{ 

int err = 0； /% エラー フラグの ク リア */ 



if (err) /* エラーが 発生した か？ */ 

longjnp(nbuf, err); /* エラーが 起きたら 強制的に 戻る */ 

} 

nain() 

{ 

static int i; 

if (i = setjmp(mbuf)) { 一 

/* longjnmO から 戻って きた 

printf ("Return from longjmpO with code Xd¥n", i); 
} else { /% © 初の setjnpO V 

printfC'setjmpO is execute<Hfn n ); 
gofuncO; 

} 

} 



227 



setmem 



害 式 i 

# include <memory.h> 

VOID setmem(dest, length, byte) 
char *dest, byte ； 
size t length ； 



解 脱 1 

dest で 示される メモリから length の 長さ だけ， byte の 値で 埋め ま す. length の 単位 は バイ ト で 
. memset( ) と は パラメータの 順番が 違う だけで 動作 は 同じです. 

戾り値 | 

ありません. 



参 照 

memsetv ； 



注 意 1 

MSX-DOS などの ワーク ヱ リア を 破壊し ないように， 注意して 下さい. 
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第 6t 標準 ライブラリ 問 数 リファレンス 



例 I 

^include <stdio.h> 
int countCIO]; 

■ain() 

{ 

int cl 

int countCIO]; 

int other; 

/* 配列 buf を 0 で 初期化す る */ 

setBenuount. sizeof (count), に char ノ 0); 
other = 0； 

while ((c = getcharO) != EOF) { 
if (lsdigit((char)c)) 

countCc 一 '。，]++; 

else 

other ++； 

} 

for (c = 0； c < 10； C++) 

printfCXd ，Xd，（s)¥n"， countCc], c); 
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setvbuf 



i 書式 i 

# include <stdio.h> 

STATUS setvbuf(fp, buf, mode, size) 

FILE *fp ； 

char *buf ； 

int mode, size ； 



厂 解脱 I 

fp で 示される ファイルの バッファに ついての パラメータ を 設定し ます. 設定で きる もの はバッ 
ファ 領域， ノ 《ッ ファ サイズ， バッファリングの 方法です. 

buf に は バッファへの ポィ ンタを 渡します. NULL が 指定され ていたと き は システム 側が 自動 
的に 割 り 当てます. （fclose( ) で 解放され ま す. )mode が _IONBF であ つ た 場合に は 無視 され ま 

size に は バッファの サイズ を 指定 します， f open () で バッファ サイズ を 指定し なかった ときに 
はバ ッファ サイズ は BUFSIZ(1024) になって います. mode 力し IONBF であつ た 場合に は 無視 さ 
れ ます. 

mode に は 次の 3 つの バッファリングの モードの うち どれ か を 指定し ます. 
(1) 一 IONBF ： バッファリング しません. 1 文字 ご とに ディスク に 読み S きします. 一般に デバ 

イスに 対して 指定し ます. 
(2HOLBF ： 行 バッファ リ ング をし ます. 出力 時には "¥n" がく ると バッファの フラッ シュを 

します. 

(3)_IOFBF ： フル バッファリング をし ます. ノ 《ッ ファ がいつ ぱいになる まで フラッシュ はし 
ません. fopen() した 直後 はこの モードに なって います. 



戻り 値 | 

mode が 上記 以外の 値で ある 時 ERROR を 返します. それ 以外で は OK を 返します. 

I 参照 1 

|_ 4.3.1 B) 高水準 入出力 関数の バッファ リ ング」 
fflushO, fopenO, setbuf ( ) 



厂 注意 1 

setvbuf() は fopen() で ファイル を オープン してから， データの 入出力 を 一切して いないと き 
にの み 実行で きます. 
この 関数 は Ver . 1 . 2 から 標準 ライブラリに 追加され ました. 
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例 



Sinclude <stdio.h> 

nainO 

{ 

FILE *fp; 
/* ファイル を 128 バイトの バサ ファで 使う */ 

if ((fp - fopen( M test M , ，V》 == NULL) { 
putsCFile cannot fflakeVn"); 
exit(t); 

} 

setvbuf(fp f NULL, JOFBF, 128)； 
/* バッファ を 128 バイトに します */ 

) 



231 



sprintf 



i 害 式 l 

# include <string,h> 

STATUS sprintf (buffer, format[, arg1 , arg2, ，..]) 
char * buffer, * format ； 

I 解 l» I 

sprintf ( ) tt, 書式 付きの 変換 を 行ない， その 出力 を buffer で 示される 領域に 格納し ます. 制御 
文字列に ついては， printf() と 同じです ので その 項 を 参照して 下さい. 

I 戻り 值 I 

出力 中に エラ 一が な ければ 0K が 返されます. そうでな ければ ERROR が 返 されます. 

I 參 照 I 

fprintfO, printfO 

| 注意 I 

printfO は 可変 パラメータ 関数な ので， 次の 宣言が あらかじめ 必要です. 
STATUS sprintf (.); 

この 宣言 は， ヘッダ ファイル string.h に 含まれて います. 
sprintf ( ) は UNIX の 標準 C の サブセット になって います. 
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_m | 

^include <stdio.h> 

/* 年月 曰 を 文字列に する */ 
char *strdate(buf, y, n, d) 

char *buf; /*11 バイ ト 以上の 領域への ボイ ン夕 */ 

int y t n, d; 

{ 

sprintf(buf t w X04d/X02d/X02d w f y, 議， d); 
return (buf); 

} 

main(argc, argv) 
int argc! 
char *argv[]; 
{ 

char buf[ll]; 

if (~argc < 3) { 

putsC'Usage: strdate <year> <nonth> <date>¥n w ); 
exit(l); 

} 

strdate(buf, atoi(argv[l]) f atoi(argv[2]), atoi(argv[3])); 

puts(buf); 

putcharC^n'); 

} 
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sscanf 



i 會 式 i 

#inlcude <string.h> 

int sscanf (line, format[, arg1 , arg2, ...]) 
char *line, * format ； 

I 解税 I 

sscanf ( ) は scanf ( ) と 同様に 書式 付 き 入力 を 行ない ます カミ， scanf( ) が 標準入力 (stdin) から 入 
力 を 読み込む のに 対し， line で 指される 文字列から 入力 を 取る 点が 異なります. line で 示される 文 
字 列はヌ ル 文字 (¥0) で 終わ ら なければ な り ません. ヌ ル 文字 自身 は 入力 されません. format 以降 
の パラ メータ は scanf ( ) と 同じな ので その 項 を 参照して 下さ い. 



厂 戻り 値 I 

sscanf() は， 実際に 代入され た 項目 数 を 値と して 返します. 戻り 値が 1 で， 変数への ポインタ 
を 3 個 パラメータに 指定したら， 2 個 目 以降 は 値が 代入され ていない ことになります. また， 文字 
列 line の 終わ り に 到達 し た 時に は 値 EOF が 返され ま す. 



厂 参照 I 

f scanf ( )， scanf ( ) 

I 注意 I 

sscanf( ) は 可変 パラメータ 関数な ので， 次の 宣言が あらかじめ 必要です. 

int sscanf し) ； 

こ の 宣言 は ヘッダ フ アイ ル string.h に 含まれて います. 
sscanf ( ) は UNIX の 標準 C の サブセット になって います. 

I 例 I 

include <stdio.h> 

nainO 

{ 

int y， b， d; 
int 

/* 年月日 を 文字列から 得る */ 

n = sscanf("1989 ノ 1/17", "Xd/WXd", &y v &u， &d); 
printf("X2d/J!2d/J!4d¥n，，， 》, d, y); 

} 
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strcat 



害 式 




char * strcat (d, s) 
char *d, *s ； 



解 脱 I 

文字列 d の 後ろ に 文字列 s を 追加 します. このと き， s を 追加す る の に 必要な 領域 は ある ものと 
して 実行され ます. また， 文字列 d fo¥0 で 終わって いなければ なりません. 



戻り 値 1 

d がその まま 返されます. 



參照] 

strcpy( )， strncaU 》 
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例 



^include <stdio.h> 
char fnaine[64]; 

/* ドライブ， バス， ペース ネーム， 拡張 子 を 与えて フルパス 名 を 作る */ 
fullpath(dst, dry, path, base, ext) 
char *dst, *drv, ^path» 本 base, *ext; 
{ 



strcpy(dst, 
strcat(dst, 
strcat(dst, 



} 



strcat(dst, 
strcat(dst, 



drv); 
path); 
"『）； 
base); 

ext); 



鋈 aiii(&rgc， argv) 
int argc; 
char *argv[]; 
{ 



switch (argc) { 



case 



case 



case 



case 



case 



1： 

puts( w Usage: fullpath [<d:>] [<path>] <base> [<ext>] 

exit(l); 

2： 



fullpathCfnaoe, 
break; 

3： 

fullpath ひ議 e, 
break; 

fullpath(fnane, 

break; 

5： 

fullpath(fnaiae, 
break; 



"a:", "¥tnp", argvCl], "$$$")； 
w a: M , Itmp", argv[l], argv[2]); 

argvCl], argv[2], argv[3]); 
argvCl], argv[2], argv[3] t argv[4]); 



putcharC^n'); 
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strchr 



厂害式 n 

# include <string.h> 



char * strchr (s, c) 
char *s, c ; 



厂 解脱 I 

文字列 s の 中から 文字 c の 最初の 位置 を 探 します. c は" ¥0" でも 構い ません. 



厂 戾り値 j 

文字 c が 見つか つたと き は そ の 位置 を 返します. そうでな レ 、場合 は NULL を 返します. 



厂 注意 1 

漢字の 文字列に は 対応 していません. 

この 関数 は Ver , 1 . 2 から 標準 ライブラリに 追加され ました. 

1 例 I 

^include <stdio.h> 

麗 ain(ctrgc, argv) 
int argc; 
char *argv[]; 
{ 

int n = 0； 
char *s, «head; 

if (—argc < 1) { 

puts( w llsage: ndot <string> ...¥n w ); 
exit(l); 

} 

ergv++; 

while (argc—) { 
/* 文字列 中に いくつの ピリオドが 含まれて いるか を 表示す る t/ 
head = s = *argv++; 
while (s = strchr (e r に，)） { 
n++; 
s++; 

} 

printfC'Xs includes Xd ，ノ （s〉¥n"， head, n); 

} 

} 
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strcmp 



# include <sthng.h> 

int strcmp (s, t) 
char *s, *t ； 



I 解 一 說 I 

文字列 s と 文字列 t を 比較し ます. 文字列の 比較 はふた つの 文字列の 先頭から， 1 文字ず つ 比較 
していき ます， ともに 文字列が 終わる 力、 文字が 異なった ところで 比較 は 終了し ます. 

I 戻り 値 I 

比較して， 同じ 文字列で あったら 0 が 返されます. 異なって いたと き は， 値 は 決って いません 
が， 範囲で どの 様な 状態 か を 知る ことができます. 
正 文字列 s > 文字列 t 

0 文字列 s = 文字列 t 

負 文字列 s く 文字列 t 



「参照 1 

strncmp^ ) 

I 注意 I 

ふたつの 文字列が 同じであった 時に， 0 が 返されます. 

I 伊 』 I 

^include <stdio*h> 

BOOL debug = FALSE; /* デバ ッ グモ— ドのク リ ァ */ 

nainvargo, argv) 
int argc; 
char *argVLJ; 
{ 

1% 最初の パラメ 一夕が" -d" だったら デバッグ モードに する */ 
if (argc > 1 && strcnp(argv[l] f "_d") == 0) { 

debug = TRUE; 

argc—J 

argv++; 

} 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



strcpy 



I 書式 I 

ff include <string.h> 



char * strcpy (d, s) 
char *d, *s ； 



厂 解脱 I 

文字列 s を d の 示す 領域に コピーし ます. d に は s の" ¥0" まで コピーし ます. このと き， d は s 
が 入る だけの 十分な 領域が ある とします. 



戻リ傕 [ 

d を そのまま 返します. 



參 照 | 

strcaU ), strncpy( ) 



厂 例 I 

^include <stdio.h> 
char fnane[64]; 

■ain(argc, argv) 
int argc; 
char *argv[]; 
{ 

if (—argc < 1) { 

puts ("Usage: apndext <basenane>¥n w ); 
exit(l); 

} 

strcpy (fnane, argv[l]); 
strcatCfnaae, ",c"》 
puts(fnane) ； 
putchardn，)； 

} 
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strlen 



厂害式 i 

# include < string.h > 



size t strlen(s) 
char *s ； 



解 脱 I 

文字列 s の 長さ を 調べます. この 長さに は 最後の，， ¥0" は 含まれません. 



戻り 储 1 

文字列 s の 長さ を 返します. 



例 I 

^include <stdio.h> 
char fnane[64]; 

/* 文字列の * 後が '¥， でなかったら 1' を 追加す る */ 

adddelinit(s) 

char *s; 

{ 

sfze— t len; 
ten = strlen(s); 
if (len != 0) 

if (s[len - 1] != f W) { 

s[!en] = ，¥¥,; 

sClen + 1] = '¥0'; 

} 

} 

Bdin(argc, argv) 
int argrc; 
char *argv[3; 

{ 

if (--argc < 1) { 

puts( w Usage: specpath <path>¥n w ); 
exit(l); 

} 

strcpy(fnaae, argvCl]); 
ctdddeliftitOTiuuieh 
strcat( w teip.$$$ w ); 
putsCfimne バ 
putchctr(，ifn つ； 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



strlwr 



厂 書式 I 

# include <string.h> 

char * strlwr (s) 
char *s ； 



I 解 _ 脱 j 

文字列 s の 英小文字 を英 大文字に 変換し ます. 
す. 

1 戻り 他 I 

S を そのまま 返します. 



こ の 関数 は S で 示された 文字列 を 直接 変更 し ま 



# 照 

strupr( ) 



「注意 | 

漠 字の 文字列 に は 対応 していません. 

こ の 関数 は Ver. 1.2 から 標準 ライブラリに 追加され ました. 

I 例 I 

^include <stdio.h> 

Haini^argc, ergv) 
int ergo; 
char *ergv[]; 
{ 

FILE ま fp; 

if ((fp = fopenCargvCll, n r n )) == NULL) { 

/* 小文字で コマンド 名， ファイル 名 を 出力す る */ 
fprintf(stderr, M Xs: %s not foimdifn', 
strlwr(argvCO]), argvCl]); 

exit(l); 
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strncat 



「書式 i 

# i nclude < stri ng.h > 

char * strncat (d, s, n) 
char *d, *s ； 
unsigned n ； 

I 解脱 I 

文字列 d の 後ろに 文字列 s の 先頭から 最大 n 文字 を 追加し， その後に" ¥0" を 付加し ます. s を 
追加す るた めの 領域 は 少なく とも n 文字 は ある ものと します. n が 0 のとき は 何も 追加され ませ 
ん， 

1 戻り 値 | 

d を そのまま 返します. 

I # 照 I 

strcat( ) 



注 意 | 

漢字の 文字列 に は 対応 していません. 

この 関数 は Ver.1.2 から 標準 ライ ブラ リ に 追加され ま した. 
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第 6 章 標準 ライブラリ 閲 数 リファレンス 



例 1 

^include <stdio.h> 
char fnaneC64]; 

1% 拡張 子 を'.' を 含めて 4 文字 以下で 追加す る */ 

addext(ext) 

char *ext; 

{ 

strncat(fname, ext, 4)； 

} 

醮 ain(argc， argv) 
int argc; 
char *argvLj; 
{ 

if (—argc < 1) { 

puts( w Usage: addext <extension>¥n w ); 
exit(l); 

) 

strcpy(fnaBe, "temp/O; 
strncat(fname, argv[l], 4)； 
puts(fnane); 
putchar('¥n'); 

} 
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strncmp 



[害 式 i 

# include <string.h> 

int strncmp (s, t， n) 
char *s， *t ； 
unsigned n ； 

I 解脱 I 

文字列 s と t を 先頭から 最大 n 文字 比較し ます. 文字列の 比較 はふた つの 文字列の 先頭から， 1 
文字ず つ 比較して いきます. n 文字 比較す る， ともに 文字列が 終わる， 文字が 異なる のどれ かが 起 
きたと ころで 較は 終了し ます. 



厂 庚り 僱 つ 

先頭の n 文字が 同じ 文字列で あ つたり， n 文字 未満で もと も に 文字列が 終る ま で 比較 して 同じ 
であったら 0 が 返されます. 異なって いたと き は， 値 は 決って いません 力、 範囲で どの 様な 状態 
か を 知る ことができます. 

正 文字列 s > 文字列 t 

0 文字列 s = 文字列 t 

負 文字列 s く 文字列 t 

I 豢照 I 

strcmpv ； 

I 注意 I 

漢字の 文字列 に は 対応 していません. 

ふたつの 文字列の 先頭からの n 文字 以下で 同じであった 時に， 0 力ま 返されます. 
この M 数 は Ver. 1.2 から 標準 ライ ブラ リ に 追加され ました， 
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第 6 草 標準 ライブラリ M 数 リファレンス 



I 例 1 

^include <stdio,h> 

/* 文字列の 先頭が" te 觸 p" かどう か 調べる */ 

istap(fn) 

char *fn; 

{ 

return (！ strnc 即 （fn, ,'tenp", 4))； 



toainCargc, argv) 
int argc! 
char *argv[]; 
{ 

if (—arse < 1) { 

putsCUsage: istnp <dst>¥n，，）； 
exit(l); 

} 

if (istip(am[l])) { 

PutsCDon't specify 'temp????' file¥n，，）； 
exit(l); 

) 

PUtsCargvCl]); 

) 
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strncpy 



厂害式 i 

# include <string.h> 

char * strncpy (d, s, n) 
char *d, *s ； 
unsigned n ； 



厂 解脱 1 

文字列 s の 先頭から 最大 n 文字 を d に コピーし ます. d に は n 文字の 領域が あ る ものと します. 



戻り 値 I 

d を そのまま 返します. 



参 照 

strcpy( ) 



厂 注^ ~ | 
漢字の 文字列 に は 対応 していません. 
この 閲数は Ver，1.2 から 標準 ライ ブラ リ に 追加され ました. 

I ^ I 

^include <stdio.h> 
define SIZE 20 
char shellCSIZE]; 

nainO 

{ 

/* 環境 変数 SHELL の 値 を 配列 shell に 入れる 

if ((p = getenv( w SHELL M » ！ = NULL) { 
strncpy (she IK p, SIZE); 
free(p); 

} 

puts(shell); 

} 
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第 6^ 標準 ライブラリ 関数 リファレンス 



strupr 



厂害式 I 

# include <string.h> 

char *strupr(s) 
char *s ； 



解 脱 I 

文字列 S の 英小文字 を英 大文字に 変換 します， こ の 関数 は S で 示された 文字列 を 直接 変更 し ま 



戻り 値 1 

S を そのまま 返します. 



「参照 I 

strlwr( ) 

I 法 意 I 

漢字の 文字列に は 対応 していません. 

この 関数 は Ver. 1.2 から 標準 ライ ブラ リ に 追加され ました. 



I 例 I 

# include <stdio.h> 

/* 引数 をす ベて 大文字に して 表示す る */ 

nainurgc, argv) 

int argc; 

char *argv[]; 

{ 

int i; 

for (i = 0； i < argc; i++) 

printfCCSSd]: Mn n 9 i, strupr(argv[i]»; 

} 
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tolower 



厂害式 i 

# include <ctype.h> 

char tolower(c) 
char c ； 



M ite 1 

c が英 大文字 だつ た ら 英小文字に し た 文字 を 返 し ま す. 



戻り 傭 I 

c が英 大文字 だつ た ら 英小文字に し た 文字 を 返 します. そうでなかったら， c そのもの を 返し ま 

す. 

I 參照 I 

islower( ) , isupper( ), toupper( ) 



注 意 I 

MSX-C では tolower( ) は 関数です. 
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第 6 章 標準 ライブラリ 関数 リファレンス 



_m ] 

^include <stdio.h> 

/* 文字列 s の 大文字 は 小文字に， 小文字 は 大文字に 変換す る */ 
char ^strchgvs) 
char *s; 
{ 

char head = s; 

while (*s) { 

if (is 卿 er(*s)) 

*s = to lower C 本 s) J 
else if (is!ower(*s)) 

*s = toupper(*s); 

s++ 

} 

return (head) ； 

} 

觐 aiiKargc, argv) 
int argc; 
char *argvLj; 
{ 

if (—argc < 1) { 

puts( M Usage: strchg <string> . . .Vn M ); 
exit(l); 

} 

argv++; 

while (argc—) { 

puts(*argv); 
puts(strchg(*argv)); 

} 

} 
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toupper 



i 書式 i 

# include <ctype.h> 

char toupper (c) 
char c ； 

I 解脱 i 

c が 英小文字だった ら英 大文字に した 文字 を 返します. 



戻り 傕 1 

C が 英小文字 だつ た ら英 大文字に した 文字 を 返 します. そうでなかったら， C そのもの を 返し ま 

す. 

I 参照 I 

i slower ( ), isupper( ), tolower( ) 

I 注意 1 

MSX-C では toupper ( ) は 関数です. 
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第 6 章 標準 ライブラリ 関数 リファレンス 



例 

ft include <stdio,h> 
int x, y; 

/* 入力 待ち をし， 'H','J','K','L' のどれ か だったら 位置 を 変更 */ 

char DvendO 

{ 

char c; 
c = getchO; 
switch (toupper(c)) { 
case ，H ，： 

x—; 

break; 
case リ" 

y++; 

break; 
case T: 

y --; 

break; 
case ，L': 

x++; 

break; 

default: 

break; 

} 

return (c); 

} 

nain() 

{ 

x = y = 0； 

puts( w push key one of ,H，, 'J，, 'K', ,L', ,Q，¥n w 〉; 
while (ivcidO 1= 'Q') { 

printf( w x = X5d y = X5d¥iT, x， y); 

} 

} 
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ungetc 9 ungetch 



厂害 式つ 

# include <stdio.h> 

STATUS ungetc(c, fp) 
char c ； 
FILE *fp ； 

VOID ungetch (c) 
char c ； 

i 解脱 I 

ungetc( ) は fp で 示される ファイルに 1 文字 戻します， ungetch( ) は 標準入力 に 1 文字 戻し ま 
す. 戻した 文字 は それぞれ 次に 実行され る getc()， getchar() で 受け取る ことができます. この 
関数 は 入力 フ アイ ルの先 読みに よく 使われます. 



厂 戻り 値 I 

ファイルが ライ トモ 一 ドで オープンされ ていた 場合と 文字 を 戻す 場所がない とき は ERROR 
が 返されます. 文字が 戻された 時 は OK が 返されます. 
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^6 章 標ゅ ライブラリ 関数 リファレンス 



例 | 
^include <stdio.h> 

nainurgc» argv; 
int argc; 
char *argv[]; 
{ 

int c; 
FILE *fp; 

if (-argc < 1) { 

puts( M Usage: countsp <f i)e>Vn M )i 
exit(l); 

} 

if ((fp = fopen(argv[l], n r n ) == NULL) { 
puts( w Fiie not found¥n，，）； 
exit(l); 

} 

/* 非 スペース 文字， スペース 文字の 総り 返し 回数 を EOF まで 表示す る xl 
while ((c = getc(fp)) != EOF) { 
un«etc((char)c, fp); 
count = 0； 

while ((c = getc(fp) ！ - ' ' && c != ，¥t，） 

count++; 
if (！ feof(fp)) 

ungetc((char)c, fp); 
printf( w Xd no.white.spaces¥n M l count); 
count = 0； 

while ((c = getc(fp) - ノリ I c == ,¥t，) 
count++; 

printf( M Xd white„spaces^n w , count); 
if (!feof(fp)) 

ungetc((char)c, fp); 

} 

} 
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unlink 



i 書式 i 

f include <io.h> 

STATUS unlink (filename) 
char *filename ； 

I 解脱 I 

filename で 指定され た ファイル を 削除し ます. filename に は ドライブ 名， パス 名， ワイルド 力 
ードを 含める こと もで きます. 

I 戻り 値 I 

指定した フ アイ ル がなかった り ， 削除に 失敗す る と ERROR を 返します. そう でない 場合 は 0K 
を 返します. 



_m ] 

ft include <stdio.h> 

顧 ainu 
{ 

puts( w Delete dsxc».$$$ Ok ？" ); 
if (getchO == 'y') 
/* テンポラリ ファイル を 削除す る */ 

unlink( w ¥¥tDtp«insxc** $$$"); 

} 
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第 6 章 標準 ライブラリ 関数 リファレンス 



write 



厂 書式 I 

# include <io.h> 



int write(fd, buf, bytes; 

FD fd ； 

char *buf ； 

size t bytes ； 



解 説 1 

ファイル ハンドル fd で 示された ファイルへ， データ を 書き込みます. 書き込む データ は buf か 
ら 始まり， 長さ は bytes で 指定し ます. 



厂 戻り 値 1 

フ アイ ルハ ン ドルが オープンされ ていない も のであった り ， オープンした 時の モー ドが リ 一 ド 
モードで あったら， 0 が 返されます， そうでなかったら bytes がその まま 返されます • 



厂參照 1 

close( ), creat( ), open( ), read( ) 



注 意 I 

write( ) は 低水準 入出力 関数です • 



厂 例 I 

^include <stdio,h> 
char buf [1003； 

nainO 

{ 

char *p, c; 
FD fd; 

/* スペースから 100 文字 を ファイル fc 書き込む */ 
for (c - , \ p = buf; c < ， ' + 100； C++) 
*P++ = c; 

if ((fd = open( w test.dat w . 0.WR0NLY)) == ERROR) { 
PutsCFIle cannot iakeVn M ); 
exit(l); 

} 

writeCfd. buf, 100)； 

} 
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第 7 章 コマンド リファレンス 



第 7 章 コマンド 1 J ファレン ス 



7.1 CF 



目 的 1 

構文 解析と 文法の チヱ ックを 行います (バーサ). また， その 結果 を 中間 言語 ファイル （.tco ファ 
ィル） として 出力し ます. 

構 文 I 

CF [オプション] ファイル 名 



オプション 一!^ 



オプション 


機 能 


- C 


コメントの ネス ト を 禁止す る， 


- e [filename] 


エラ一 メ ッ セージ を ファイルに 出力す る. filename で ファイル 名 を 指定で き 
る. 


- f 


関数と バラ メータに 対する 暗黙の 宣言 を 行う. 


-j 


文字列 中の 漢字 を 正 し く 認識す る . 


-m 


コンパイラの ワーク 用 テーブルの P ： S ： H の 割合 を 表示す る. 


-o[filenamej 


中間 言語 フ アイ ルのフ アイ ル名を 指定す る. 


-rP ： S ： II 


コ ン パイ ラの ワーク 用 テーブル を P ： S ： H の 比率で 割当てる 


-s 


ソースファイルの エラ一 が検知 されても， バッチ ファイルの 実行 を 中断し ない. 




ボイ ンタ と 整数の 間の 自動 型変換 を 可能に する. 



r 参照 ページ I 

26 ページ r 2.2.1 CF (バーサ) 
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7.2 CG 



厂 目的 I 

CF が 出力した 中間 言語 を アセンブリ 言語に 変換し ます （コード ジェネレータ）. 

I 構文 I 
CG [オプション] ファイル 名 



オプション 一 K 



オプション 


機 能 


- k 


.tco ファイル を 自動的に 削除す る. 


-1 


グロ ーノ 《 ル シ ン ボ ル名 全体 を 有効 にす る. 


-0 [filename] 


出力 ファイルの 名前 を 指定す る. 


-rN 


シンボル テーブル 領域と して， N バイト 確保す る. ただし， N は 10 進数， 


一 u 


処理の 進行状況 を 表示し ない. 



r 参照 ページ j 

36 ページ 「2,2.3 CG (コード ジェネレータ）」 
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第 7 章 コマンド リファレンス 



7.3 FPC 



目 的 1 

関数の 引数の 整合性 を チヱ ック します （パラメータ チヱ ッ 力）. 



構 文 I 

FPC [オプション] ファイル 名 1 ファイル 名 2 ••• 



オプション 一 K 



オプション 


機 能 


-c 


.tco ファイルの 連結 


- d 


don't care 関数の 指定 


- i 


間接 呼び出し に対して 警告 を 出す. 


- s 


ェ ラ 一が 検出 されても バッチ フ アイ ルの 実行 を 中断 しない. 


- 1 


int, unsigned, ポインタ を 別の 型と して 扱う. 


- u 


未定義 関数に 対する 参照 を チュッ ク しない. 



r» 照 ページ i 

32 ページ 「2.2.2 FPC (パラメータ チェッカ） 
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7.4 MX 



目 的 1 

ライブラリの 作成， 保守 を 支援し ます. ソースファイルの モジュール (関数 単位) への 分割， ラ 
ィ ブラ リ ファイル 作成までの 手順の 出力 をし ます. （ライ ブラ リ 保守 支援 ツール） 



1 構文 1 

MX [才 プシ 




ン] ファイル 名 [モジュール 名 1 モジュール 名 2 •••] 


| オプション 一 K| 




オプ^/ヨン 


機 能 


-1 


LIB80 を 呼び出して ライ ブラ リ ファイル を 作成す る 手順 も 出力す る. 


-o[path¥] 


モジュール を ディ レク ト リ path に 抽出す る. 



r 參照 ページ i 

93 ページ 「4.5,2 ライブラリ 保守 支援 ツール MX について」 
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第 8 車 エラ一 メッセージ 一^ 

第 8 章 エラー メ^ z — ジー黧 

この 章で は MSX-C コ ン パイ ラが 発生させる エラ一 メ ッ セージの一 覧を 示します. エラー メ ッ 
セージ （英文） とその 日本語訳 とその 主な 内容 を 示して います. 実際 コンパイルで エラーが 起き 
たと きに ご 利用 下さい， 

メッセージの 説明の 順番 は， コマンド ごとに 記号 を 無視して， アルファベット 順に 配列して い 
ます. 

8.1 CF の エラー メま ージ 



srray of Tunction 

関数の 配列 を 作って います. 

要素が 関数になる よ う な 配列 は 作る こ と はでき ません. 

bad # ？?? 

# コマンドの 使用法が 違います. 

# コマンドの ある 場所が 式 中で あったり プリ プロセッサ にない コマンドが 指定され てい 
ます. 

bad abstract declarator 

抽象 宣言 子が 正しくありません. 

抽象 宣言 子 は キャストの 型 指定で 使われます. 

bad assignment 

代入が 間違って います. 

代入 先が 変数な ど を 含む 式に なって いると 発生し ます. 

bad cast 

間違った キャス トを 行って います. 

配列 や 構造体， 共用 体に キャストし ています. キャスト は 数値 や ポインタの 属性 を 変更 
する もので 配列 や 構造体， 共用 体に キャス 卜する こと はでき ません. 
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bad character 

不適当な 文字が あります. 



コント 口 ール 文字が ソースファイルに あったり， 行末 以外に' ¥ ，が あ ります. 

bad condition 

条件が 不正です. 

if, while などの 条件 判断に 使われる 条件に 合わない 表記が あ ります. 

bad conditional expression (missing ，？， ) 

条件 式 （3 項 演算子） の 使い方が 違います. 

条件 式で？， がない 場合に 発生 します. 

bad constant expression 

定数 式が 不正です。 

配列 定義 時の 要素 数の 指定な ど， 定数が 必要な ところ に 変数 や 関数が あ ります. 

bad # define statement 

# define の 使用法が 違います. 

識別子 として 正しく ない 文字が' 含 まれて います. 

bad element 

文が 存在 していない か 不正です. 

ラベルの 後 や， while などの 後ろに は 文が 必要です が， それが 見つかりません. 

bad element encountered externally 

関数 外での 文が 不正です. 

関数の 外側で 文が 正し くないと こ の エラーが 発生し ま す. 関数 中であった 場合に は" bad 
element" エラーが 発生 します. 

bad # ifdef statement 

#ifdef の 使用法が 違います. 

識別子と して 正しく ない 文字が 含まれて います. 
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bad # if ndef statement 

#ifndef の 使用法が 違います. 

識別子と して 正し く ない 文字が 含まれて います. 

bad # include statement 

# include の 使用法が 違います. 

ファイルの 指定に はく， > か " で M まなければ なりません. 

bad indirection 

間接 指定が 間違って います. 

この エラー は 間接 指定の" を ポインタ につけす ぎた とき 発生し ます. つまり， 普通の 
ボイ ンタ であるのに 2 つ 以上つ ける と 起き ます. 

bad number 

数値の 範囲 外の 文字が 使われて い ま す. 

数値 は 8 進数， 10 進数， 16 進数が 使用で きます が， それぞれ 0 から 7， 0 から 9, 0 から 
9 と a から f が 範囲です. 

bad option ： < 文字 > 

存在し ない スィ ツチ' '-く 文字〉" が 指定され ています. 

指定で きる スィッチ は， ceftjmors の 各 文字です. 

bad parameter list 

弓 I 数 リストが 間違って います. 

引数つ き マクロの 定義 中， 仮 引数 名が 不正 か， 仮 引数の 区切りが"，" でない もの 力 《使われ 
ています. 

bad parameter type 

弓 I 数の 型が 数値 型ではありません. 

関数の 呼び出しの 際に， 弓 I 数が 配列， 構造体， 共用 体で 呼び出され ています. 直接 渡す 
こ とがで きないので， 普通 は 渡す も のの 先頭への ポィ ン タ で 代用 します. 
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bad parameter type 'く 仮 引数〉， 

く 仮 引数〉 の 型が 数値 型ではありません. 



関数の 定義の 際， 仮 引数が 関数， 構造体， 共用 体と して 宣言され ています. 直接 受け取れ 
ない ので， 普通 は 渡される ものの 先頭への ボイ ンタで 代用し ます. 

bad # prsgms statement 

# pragma の 使用法が 違い ま す. 

パラメータが 予約語ではありません. 

bad storage class 

記憶 クラス の 指定が 間違つ ています. 

関数 定義 時に extern をつ けて いたり， 関数 宣言 時に static をつ けて います. 

bad switch expression 

switch で 使われる 式が 不正です， 

switch の 式 は 数値 型の 結果が 必要です. 

bad table ratio 

"マ" スィッチで 指定され た 比率が よ くありません. 

J: 匕 率に は 正の 数 を 指定して 下さい. 

bad type in cast 

キャスト する 型が 不正です. 

キャスト する 型が キャス 卜で きない もの （関数な ど） になって います. 

bad # undef statement 

#undef の 使用法が 違います. 

識別子と して 正し く ない 文字が 含まれて います. 
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'break' outside switch/break 

switch の 外側に break が あ ります. 

break を ループ や switch などの プロ ックの 外側で 使って います. 

cannot initialized 

初期化で きません. 

自動 （auto) 変数の 配列 は 初期化で きません • 

cannot make C く Tile,] 

く file〉 が 作成で きません. 

.tco ファイル や. dia ファイル を 作成 するとき に， ディ レク ト リゃ ディスク 容量が いっぱ 
いで あったり， ディレクトリが 存在 しないな ど， ファイル を 作成す る ことができな いと 
きに 表示され ます. 

cannot open [^file>] 

< file > が 見つかり ません. 

指定した C の ソース フ アイ ルかィ ン クルー ドフ アイ ルが 見つからない と き に 表示され 
ます ♦ インク ル一 ド ファイル は 環境 変数 INCLUDE によって デフォルト ディ レクト リを 
設定し ます. 

'case' after default 

default より 後ろに case が あ ります. 

MSX-C では default より 後ろに case を 書く こと はでき ません， 

'case' outside switch 

switch の 外側に case が あ ります. 

case は switch の 内部で なければ 使用で きません. 

conflict definition '< 識別子 >' 

< 識別子 〉 の 宣言が 一致 しません. 

2 つ 以上の 外部 • 前方 参照の 宣言で， 関数 や 変数の 宣言が一 致して いません. 関数の 前方 
参照の 宣言と 定義と が 違う ことが 考えられます. 
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conflicting number of macro parameter 

マクロの 引数の 数が 合って いません. 



引数 付きの マクロで は， 定義と 参照の 引数の 数 は 同じで なければ なりません. 

'continue' outside loop 

while, for な ど ルー プの 外側 に continue が ありま す， 

ループの 外側で は continue は 使えません. 

'default* appeard twice 

switch の ブロック 内に default が 2 回 以上 出現し ま した. 

default は その他 を 示す ラベルで すので， 】 回しか使ぇません， 

'default' outside switch 

switch の 外側に default が あ ります. 

default は switch の ブロック 内で ない と ラベルと して 使えません， 

disk full 

ディスクが いっぱいです. 

データの 書き込み 中に ディスクが いっぱいに なりました. 処理が 続行で きません. 

'double' not supported 

double はサ ポー ト されて いません 

duplicate 'case' label 

switch で case の 定数 値が 同 じ も のが 2 つ 以上 あ り ま す. 

case の 後の 定数 はすべ て 違う 値で なければ なりません. 

duplicate label ，< ラベ ノレ >' 

同じ 名前の < ラベル > が 2 つ 以上 あ ります. 

ラ ベル 名 は， 関数の 中で 同じ 名前 をつ ける こと はでき ません， 



266 



第 8 章 エラーメッセージ 一覧 

duplicate member 

構造体 や 共用 体の 中に 同じ メンバ 名が あります， 

ひとつ の 構造体， 共用 体の 中に は 同 じ メ ンバ名 は 使え ませ ん. 

duplicate storage class 

記憶 クラスが 2 つ 以上 指定 されて います. 

extern と static な ど 記憶 ク ラ ス を 指定す る 語が 2 つ 以上 使われて い ま す. 

duplicate tag 'く タグ,' 

同じく タグ > で 構造体 や 共用 体が 定義 されて います. 

タグ 名 はおのお のの 構造体 や 共用 体で， 別の 名前 をつ けなければ なりません. 

duplicate type specifier 

変数の 型の 指定が 2 つ 以上 あ ります. 

int と char な ど 型 を 指定す る 語が 2 つ 以上 あ ります. 

，(， expected 

"("がありません. 

if 文の 条件 式の 前な ど， 構文 上" ("が 必要な とき 発生し ます. 

')' expected 

")" がありません. 

if 文の 条件 式の 後ろな ど， 構文 上")" が 必要な とき 発生し ます. また， 抽象 宣言 子で")" が 
ない とき も 発生し ます. 

、 ： ' expected 

" ： "がありません. 

case 文の 定数の 後ろ や default の 後ろに" ： "がない ときこの メ ッ セージが 表示され ます. 
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， ； ' expected 

" ； "がありません. 

ひとつの 文 は"；" で 終了し なければ なりません. "；" がない のに 次の 文 （制御 文） が 来 
ています. 

'] ， expected 

"] "がありません * 

配列 定義 時に 要素 数 を 指定す る 数値の 後ろに"] "がありません. 
'} ， expected 

"r ，がありません. 

配列の 初期化 をした 場合， " { "に 対応す るよ う に" } "を 置かなければ な り ません. 

'float' not supported 

float はサ ポー ト されて いません 

function cannot appear 

関数 は 指定で きません. 

： 造体メ ンバ とし て 使用 し た 場合な ど に 発生 します. 



function expected 

関数の 定義が 必要です. 

関数の 定義 をすべき ところで 別の 文字列な ど をお いた 場合に 発生し ます. 

function returns structured data 

関数の 戻 り 値の 宣言が 構造体 また は 共用 体に なって います. 

関数 は 構造体 や 共用 体 を 返す こと はでき ません， 

hash table over flow 

ハツ シュ テーブルが オーバーフロー しま した. 

識別子の ハッシュ 値 を 格納す る 場所が 不足し ました. ，，-r" スィ ツチで ワーク テーブルの 
比率 を 修正して 下さい. 「2.2.1 CF (バーサ）」 の" _r" スィ ツチの 項 を 参照して 下さい， 
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heap over flow 

ヒ 一 プがォ 一 バー フローし まし た. 

ファイルの インクルードが 多かったり， auto 変数 を 多量に 宣言す ると 発生し ます. ま 
た， 式 等が 複雑な 場合 も 発生し ます， 

improper function mode 

不適当な フ アンク ショ ン モー ド です. 

nonrec, recursive が 変数に 対 し て 使われて い ま す. 

ff include too nested 

# include の ネストが 深す ぎます， 

MSX- C では ィ ン クルー ド ファイルの ネス トは 4 重までと なって います. それ 以上 使つ 
ている 場合に はィ ン クルー ドフ アイ ルを 分割す る な どして 下さい. 

known dimension expected 

配列の 大き さ を 定義して いません. 

配列の 大きさ は 定数で 指定し なければ なりません. 

'long' not supported 

long はサ ポー 卜 されて いません 

ト value required 

左辺 値が 必要です. 

記憶 位置 を 示す 式 を 左辺 値と 呼びます. 値 を 代入す るに は 変数の 名前な ど， 記憶 位置 を 
示す 式が 必要です. 

missing ，)， 

")" がありません. 

式 中で， ")" が 不足して います， 
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missing ， ： ， 

" ： "がありません. 

条件 式 （3 項 演算子） "？ ： "の" ： "が あ り ません. 

missing ，」 ， 

"] "がありません. 

式 中で， "] "が 不足して います. 

missing ,} , 

"} "がありません. 

式 中で， "} "が 不足して います. 

missing conaixion 

条件が ありません. 

条件 判断に 使う 条件が あ りません. 

missing identifier 

識別子が ありません. 

識別子と は， 変数 名， 関数 名， 配列 名な どの ことです • 識別子がない のに， 文， 式が 書 
かれて います. 

missing member name 

メ ンバ 名が ありません. 

構造体 変数 や 構造体 変数への ポィ ンタに 続く メ ンバ 名が あ り ません. 

missing operator (or semicolon) 

演算子 か" ； "がありません. 

空白で 区切られた 数値 や 変数 名が 複数 続いて いる 可能性が あ ります. 
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missing quote 

文字列が （ " ） で 終わって いません. 

文字列の 複数 行に わたる 記述で， 行末に，' ¥ "をお かずに 改行した 場合 発生し ます. 

missing tag 

タグ 名が ありません. 

構造体 変数の 定義が なく， タグ 名の 指定がない 場合に 発生し ます. 

not appear in parameter list , <fe§|&>' 

"く 仮 引数〉" は 引数 リ ストに あり ません. 

引数 リストに ない 仮 引数が 引数の 宣言に 含まれて います. 

parameter cannot appear here 

パラメータの 指定 はでき ません. 

関数の 宣言で バラ メータ を 指定 してい る 場合 発生 します. 

pointer type mismatch - use cast 

ポインタの 型が 合って いません. キャス トを 使用して 下さい. 

MSX-C では， ポィ ンタの 相互 変換 は 必ず キャス ト しなければ なりません， 

pool over flow 

プ一 ルがォ 一 バー フローし まし た. 

識別子 （# define で 定義した もの や， 変数 名） を 格納す る プールが 不足し ました， "マ" ス 
イッチで ワーク テーブルの Jt 率 を 修正して 下さい. 「2.2.1 CF (パーザ）」 の" -r" スィ 
ツチの 項 を 参, 照して 下さい. 

precedence error 

優先順位 エラーです. 

優先順位で 正しくな いものが 発生し ました. で， リ， を 使って 優先順位 を 明確に 行って 下 
さい. 
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redeclaration of 'く itt 別 子〉， 

" く 識別子 > "が 2 重 定義 されて います. 



変数 • 関数が 2 重に 定義 されて います. 

sizeof(func) not permitted 

sizeof (func) は 許可 されて いません. 

関数の サイズ は 求められません. 



sorry, too small memory 

メモリ 不足に より コ ン パイ ル 不可能です. 



stack over flow 

スタックが オーバ一 フローし ました. 

式 等が 複雑す ぎます. 



static function 'く 関数〉' not defined 

ス タティ ックな 関数の く 関数〉 は 定義され ていません. 



スタティックな 関数 は， その ソースファイル 中で 定義し なければ いけません. ス タティ 
ックな 関数の く 関数 > の 宣言が あって， 関数の 定義が ありません. 



symbol table over flow 

シンボル テーブルが オーバーフロー しました. 



ソース プログラム 中に 識別子が 多すぎる ために， その 情報 を 格納す る シンボル テーブル 
が 足り なくなりました. ，，-r" スィ ツチで シンボル テーブルの 比率 を 大き く なる ように 指 
定 して 再 コンパイルして 下さい. 「2.2.1 CF (バーサ）」 の" -r" スィッチの 項 を 参照し 
て 下さい， また， 識別子 （# define で 定義した もの， 構造体， 外部 変数な ど） で 不要な も 
のがあるなら， それ をな くす こ とで も 回避す る ことができます. 



syntax error 

構文に 誤りが あります. 

too many initializers 

初期化の た め の 定数が 多す ぎます. 

配列の 初期化の 際， 配列の 大きさより も 初期値の 数の 方が 多い と 発生し ます. 
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too much parameters 

パラメータが 多すぎます. 

引数 付き マクロに おいて 引数が 11 以上に なった ときに 発生し ます. 

type mismatch 

型が 合って いません. 

数値 型と 構造体， 共用 体 変数の 間 または， 異なった 構造体， 共用 体 変数 間で 代入 を 行つ 
た 場合に 発生し ます. 

undeclared function '< 関数 >' 

< 関数〉 は 宣言され ていません. 

MSX-C では， 鬨数を 使用す る 際 は， それまでに その 関数の 宣言 または 定義が 必要です. 

undeclared identifier 'く 識別子〉， 

く 識別子〉 は 宣言され ていません. 

変数の 宣言 を 忘れて いるか， 変数 名 を 間違えて います. 

undeclared member name '< メ ンメ 《>' 

< メンバ > が 宣言され ていません. 

構造体， 共用 体の 宣言で メンバの 宣言 を 忘れて いるか， メンバ 名 を 間違えて います. 

undeclared parameter ，く 仮 弓 1 数 >' 

く 仮 引数 >が 宣言され ていません. 

引数の 宣言 を 忘れて いるか， 仮 引数 名 を 間違って います. 

undefined label ，く ラベ ノレ >' in function 'く 関数 >， 

く 関数〉 に はく ラベル > は 定義され ていません. 

goto 文の 飛び 先の ラベル 名が， その goto 文の ある 関数 内で 見つからない 場合に 発生し 
ます. 
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undefined struct/union 

構造体 ノ 共用 体が 宣言され ていません. 



構造体， 共用 体の 宣言よりも 先に 構造体， 共用 体 変数の 宣言が きている 場合に も 発生し 
ます. 

unexpected eoT 

途中で フ アイ ルが 終わ つてい ます. 

関数， コメント 以外の 部分で フ ァ ィ ルカ; 終わった 場合に 発生し ま す. 

unexpected eof in this comment 

コメントの 途中で ファイルが 終わって います. 

コメント の"/ * "が 多 くフ アイ ルの 終わ りに なっても 対応す る " * /"が 見つか らな いとき 
に 発生し ます. 

unexpected eot inside function ，く閬 数パ 

く 関数〉 の 途中で フ ァ ィ ルが 終わ つてい ます. 

"{ "の 数が 多 く， フ アイ ルの 終わ り になっても 関数の 終了 を 表す" } "が 見つからない と き 
に 発生し ます. 

useless expression 

演算 結果が 使われて いません， 

文の 最初の 演算子が， 代入 演算子で も インク リメ ント • デク リメ ント 演算子で もない 演 
算 子のと きに 発生し ます. 

'while' expected 

while がありません. 

do while の while が ルー プの ブロックが 終っても 見あたりません. 
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8.2 CG の エラー 火 yfe —ジ 



bad option ： く 文字 > 

存在し ない スィ ツチ"- く 文字 > "が 指定され ています. 

指定で きる スィッチ は， rkulo の 各 文字です. 

cannot make ： < ファ イリ レ > 

くフ アイ ル> が 作成で き ません. 

.mac ファイル を 作成 するとき に， ディ レク トリ や ディスク 容量が いっぱいで あったり, 
ディレクトリ が 存在 しないな ど， フ アイ ルを 作成す る こ と がで きないと き に 表示され ま 
す. 

cannot open ： < フ ァ i ノレ > 

く ファイル〉 が 見つかり ません. 

指定 した. tco フ アイ ルが 見つか らな いとき に 表示 されます. 

fuction overflow in "く te?$>'， ...specify less than <数> by - r 

く 関数〉 で コード 生成 用の 領域が なくなりました. "マ" スィ ツチで く 数 > より 小さい 数 
を 指定して 下さい， 

CG では 空き 領域 を シンボル テーブルと コード 生成 用の 領域に 分割して 使用して いま 
す. "マ" スィ ツチで シンボル テーブル を 小さ く し， コード 生成 用の 領域 を 大き く して， 再 
度 CG を 起動して 下さい. シンボル テーブルの 大きさ を どんな 値に 設定しても， "symbol 
table overflow ..." と 交互 に 発生す る 場合 は， 関数 を 分割す るか ファイル を 分割して 下さ 
い. 

illegal .tco file at "く閲 数〉 "く 行 > ： < 桁〉 

..tco フ アイ ルが正 しくありません. 

.tco ファイルが 壊れて います. 再度， CF から 始めて 下さい. 

sorry, too small memory 

メモリ 不足に より コ ン パイ ル 不可能です. 
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stack overflow 



スタックが 足りません. 

symbol table overflow in "く閬 数 >" ...specify more than <数> by - r 

く 関数〉 で シンボル テーブルが なくなりました.， -r ，スィ ツチで く 数〉 より 大きい 数 を 指 
定 して 下さい. 

CG では 空き 領域 を シンボル テーブルと コード 生成 用の 領域に 分割して 使用して いま 
す. ，- r ，スィッチで シンボル テーブル を 大きく して， 再度 CG を 起動して 下さい. シンポ 
ル テーブルの 大きさ を どんな 値に 設定しても， "function overflow …"と 交互に 発生す る 
場合 は， 関数 を 分割す るか ファイル を 分割して 下さい. 

warning ： > > more than 8 bit in ，，く 関数 >" 

警告 ： 8 ビッ ト 以上 右シフ ト しています. 

8 ビット 値 を 8 ビッ ト 以上 右シフ ト すると， 必ず 0 になって しまいます， 

warning ： < < more than 8 bit in "< 関数 >" 

警告 ： 8 ビッ ト 以上 左 シフ ト しています. 

8 ビッ ト値を 8 ビッ ト 以上 左シフ ト すると， 必ず 0 になって しまいます. 

warning ： << more than 16 bit in "< 関数^" 

警告 ： 16 ビッ ト 以上 左 シフ ト しています. 

16 ビッ ト値を 16 ビッ ト 以上 左シフ ト すると， 必ず 0 になって しまいます. 

warning ： too big char constant く 数〉 m ，く 関数, 
警告 ： キャラクタ 定数の 値が 大きす ぎます. 

char 型 は- 255 から 255 の 範囲で 値 を 設定して 下さい. 
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第 8 章 エラ一 メッセージ 一覧 

8.3 FPC の エラー メ *ylz ージ 



bad option ： -く 文字 > 

存在し ない スィ ツチ"- く 文字〉" が 指定され ています. 

指定で きる スィッチ は， istucd の 各 文字です， 

cannot make ： し< ノア つ ノレ >j 

く ファイル〉 が 作成 できません. 

"- c" スィ ツチ を 指定して. tco ファイル を 連結す る 場合に 発生し ます. ディ レク ト リゃデ 
イス ク 容量が いっぱいで あったり， ディレクトリが 存在 しないな ど， ファイル を 作成す 
る ことができない ときに 表示され ます. 

cannot open i 〔< ファっ メレ >_| 

く ファイル〉 が 見つかり ません. 

指定した. tco ファイルが 見つからない ときに 表示され ます. 

in < < フ アイ ル> > "<閭 数 1 >" calls "< 関数 2>" ： conflicting number of arguments 

引数の 数が 合って いません. 

く ファイル〉 中の く 関数 1〉 で 呼び出して いるく 関数 2> の 引数の 数が， く 関数 2〉 の定 
義と 合って いません. 

in くく ファイル > > ，，く 閲数 1 > " calls " < 閱数 2 > " ： conflicting return type 

関数の 戻 り 値の 型が 合つ ていません * 

く ファイル〉 中の く 関数 1> で 呼び出して いるく 関数 2〉 の 返す 型が， く 関数 2〉 の 定義 
さい. 

in くく ファイル〉〉 "く 関数 1>，， calls ，，く 関数 2 > " ： <Nth> argument conflict 

N 番目の 引数の 型が 合って いません. 

く ファイル > 中 のく 関数 1〉 で 呼び出して いるく 関数 2〉 の 引数の 型が， く 関数 2> の定 
義と 合って いません. 1 番目， 2 番目， 3 番目の 引数の 時には" く Nth> "は それぞれ， ，， 
1st"， "2nd", "3rd" になります. 
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in << ファイル >> ，，く 関数 1 >，， calls "く 関数 2>，， ： undefined 
関数が 定義され ていません. 



く ファイル〉 中の く 関数 1> で 呼び出して いるく 関数 2〉 が 定義され ていません. 



in << ファっ ノレ >> ，，く 関数 >" ...sorry, can't check indirect call 
間接 呼び出しの 関数 は 引数 チヱ ッ ク はでき ません. 



< ファイル > 中 のく 関数 > 内で 別の 関数 を 間接的に 呼び出し ています. FPC では 間接 呼 
び 出 しの 関数の 引数 チェ ッ ク はでき ません. 



in << ファイル >> "< 関数 >" was multiple defined 

く 関数 > が 2 重 定義され ています. 



く ファイル〉 中で く 関数〉 が 2 重 定義され ています. 



missing func list 

関数の リス ト がありません. 



"-d" スィ ツチ を 指定した 場合に は， 次の 引数に カンマで 区切られた 関数 名の リストが 必 
要です. 



missing outputnle 

出力 ファイルが ありません， 



"- c" スィ ツチ を 指定した 場合に は， 次の 引数に 連結した. tco ファイル を 格納す るた めに 
フ アイ ル 名が 必要です. 



too many files 

ファイルが 多すぎます. 



チェック する ための. tco ファイルが 多すぎます. 
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第 8 章 エラーメッセージ一 貲 



8.4 MX の エラー メ まージ 



bad option ： -く 文字〉 

存在し ない スィ ツチ "-く 文字〉" が 指定され ています. 

指定で きる スィッチ は， lou の 各 文字です. 

cannot make ： L く ファイス レ>」 

くフ アイ ル〉 が 作成で きません. 

分割され た ファイル を 作成で きません. ディ レク ト リゃ ディスク 容量が いっぱい であつ 
たり， ディレクトリが 存在 しないな ど， ファイル を 作成す る ことができない ときに 表示 
されます. 



cannot open ： < ファづ ノレ > . mac or < ファ イジ レ > .tco 

分割 をす る ファイル 力た mac ファイル でも. tco ファイル でも 見つかり ません. 



illegal .tco file 

.tco ファイルが 正しくありません. 



.tco ファイルが 壊れて います. 再度， CF から 始めて 下さい. 



missing ENDMODULE 

'ENDMODULE ，が 見つかり ません, 



アセンブラ ファイル （.mac ファイル） で， モジュールの 開始で ある" MODULE" はあり 
ま したが， "ENDMODULE" が 見つからずに ファ ィ ルが 終り ま した. 

out of memory 

メモリが 不足し ました. 

分割され た モジュール 名 を 保存して おくた めの 領域が ありません， 分割 前の ファイル を 
分割して， 再度 CF から 始めて 下さい. 

Skeleton file AREL.BAT not found 

スケルトン ファイル arel.bat が 見つか りません. 

,mac ファイル を 分割す る 場合に は， カレント ディ レク ト リか MX コマンドの ある ディ 
レクト リに， ァ セン ブル 手順 を 記述 した ファイル arel.bat が 必要です. 
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Skeleton file CREL.BAT not found 

スケルトン ファイル crel.bat が 見つか りません. 

.tco ファイル を 分割す る 場合に は， カレント ディ レクト リか MX コマンドの ある ディ レ 
ク トリに， コ一 ド 生成， アセンブルの 手順 を 記述した ファイル crel.bat が 必要です. 
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第 9 舉 標準 ライブラリ 関数 一^ 



第 9 章 欉準ラ <7 ラ U 園 数 一覧 

ここで は， 標準 ライブラリ 関数の 簡単な 一覧 を 示します. それぞれの ライブラリ 関数の 詳細に 

ついては， 「第 6 章 標準 ライブラリ 関数 リファレンス」 を 参照して ください， 



9.1 ファイル 入出力 面 数 



9.1.1 商 水準 入出力 関数 



瞧名 


用 途 


参照 ページ 


clearerr 


エラー 状態 をク リアす る 


133 


fclose 


ファイルの クローズ 


144 


fcloseall 


標準 入出力 以外の フ アイ ルを すべて クローズ 


144 


feof 


ファイルの エンド ォブフ アイ ルの 判定 


146 


ferror 


フ アイ ルが書 き 込み ェ ラー を 起こした か 


148 


fflush 


ファイル バッファの フラッシュ 


149 


fgets 


文字列 をフ アイ ルか ら 読み込み 


151 


fileno 


ファイルの フ アイ ルハ ン ド ル を 返す 


152 


flushall 


すべて の ファイル バッファの フラッシュ 


153 


fopen 


ファイルの オープン 


154 


fprintf 


フ アイ ル への 書式 付 き データ 出力 


156 


fputs 


文字列 を ファイルへ 出力す る 


158 


fread 


フ アイ ル から データ を 読み込む 


159 


fscanf 


ファイルからの 窗式 付き データ 入力 


163 


fsetbin 


入出力 を バイナリ • モードに する 


165 


fsettext 


入出力 を テキス ト • モードに する 


167 


fwrite 


ファイルに データ を 書き込む 


168 


getc 


ファイルから 1 文字 読む 


170 


getchar 


標準入力から 1 文字 読む 


170 


gets 


文字列 を樑準 入力 から 読む 


177 


printf 


標準出力への 杏 式 付 き データ 出力 


207 


putc 


1 文字 を ファイルに 書き出す 


209 


putchar 


1 文字 を 標準出力に 書き出す 


209 


puts 


文字列 を 標準出力へ 出力す る 


212 


scanf 


標準入力 か ら の 書式 付 き データ 入力 


220 


setbuf 


バッファの 制御 方法の 設定 


224 


setvbuf 


バッファの 制御 方法の 設定 


230 
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ungetc 


1 文字 を ファイルへ 戻す 


252 


ungetch 


1 文字 を 標準入力へ 戻す 


252 


9.1. S ほ 水準 入出力 ffi 数 




関数 名 


用 途 


参照 ページ 


close 


ファイルの クロ一 ズ 


134 


creat 


フ アイ ルの 作成 


135 


eof 


フ アイ ルのェ ンド ォブフ アイ ルの 判定 


136 


isatty 


フ アイ ルがデ バイ ス かどう かの 判定 


182 


open 


ファイルの オープン 


204 


read 


ファイルの 読み込み 


215 


write 


ファイルの 書き出し 


255 



9.2 文字列お よ 敗 字 処理 関数 



関数 名 


m 途 


参照 ページ 


atoi 


文字列 を 整数に 変換す る 


126 


lsalnum 


文字が アルファベット， 数字 かどう かの 判定 


179 


isalpha 


文字が アルファべ ッ 卜 かどう かの 判定 


181 


iscntrl 


文字が コントロール キャラクタ かどう かの 判定 


183 


isdigit 


文字が 数字 かどう かの 判定 


184 


iskanji 


文字が 漠 字の 第 1 バイ ト か ど う かの 判定 


185 


iskanji2 


文字が 漢字の 第 2 バイ ト かどう かの 判定 


187 


islower 


文字が 小文字 か ど う かの 判定 


189 


isspace 


文字が 空白 文字 かどう かの 判定 


190 


isupper 


文字が 大文字 か ど う かの 判定 


191 


isxdigit 


文字が 16 進数 か ど う かの 判定 


192 


sprintf 


デー タ の 書式 付 き 出力 を 文字列 に対して 行う 


232 


sscanf 


デー タ の 書式 付 き 入力 を 文字列 か ら 行う 


234 


strcat 


2 つの 文字列 を 連結す る 


235 


strchr 


文字列から 文字 を 見つける 


237 


strcmp 


2 つの 文字列 を 比較す る 


238 


strcpy 


文字列 を コピーす る 


239 


strlen 


文字列の 長さ を 返す 


240 


strlwr 


文字列 中の 大文字 を 小文字に する 


241 


strncat 


2 つの 文字列 を 上限つ きで 連結す る 


242 
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strncmp 


2 つ の 文 子歹 1 j を 上限つ き で 比較す る 


244 


strncpy 


文字列 を 上限つ きで コピーす る 


246 


strupr 


文字列 中 の 小文字 を 大文字 にす る 


247 


tolower 


大文字 を 小文字に 変換す る 


248 


toupper 


小文字 を 大文字に 変換す る 


250 



9.3 メモリ 管理鹏 



9.3.1 抵水攀 メモリ 管理鹏 



rsvstk 


スタック 領域 を 確保す る 


218 


sbrk 


メモリ ブロック を 割り付ける 


219 


9.3.2 


高水準 メモリ 管理 n 数 






alloc 


メモリ ブロック を 割り付ける 


124 


free 


alloc で 割 り 付けた メモリ を 解放す る 


161 



9,4 ディレクトリ 颺数 



chair 


カレント ディ レクト リを 変更す る 


132 


expargs 


ワイルド カー ド を 含む ファ ィ ル名を 展開す る 


142 


getcwd 


カレント ディレクトリ を 獲得す る 


174 


mkdir 


サブ ディ レク ト リを 作成す る 


202 


rmdir 


サブ ディ レクト リ を 削除す る 


217 



9.5 プログラム 操作 関数 



execl 


プログラムの チ ヱイ ン (1) 


137 


execlp 


プログラムの チ ヱイ ン (2) 


137 


execv 


プログラムの チ エイ ン (3) 


139 
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execvp 


プログラムの チェイン (4) 


139 


exit 


プログラムの 実行の 終了 


141 


一 ex it 


プログラムの 実行の 終了 


141 



9.6 キーボード， I/O 関数 



getch 


キーボードから 1 文字 入力す る 


171 


getche 


キーボードから 1 文字 入力す る 


173 


inp 


I/O ポートから データ を 入力す る 


178 


kbhit 


キー入力が あるか どうか を テス 卜する 


194 




I/O ポートへ データ を 出力す る 


206 


outp 


sensebrk 


Ctrl + C, Ctrl + STOP 入力の テスト 


222 



9.7 機械語， MSX-DOS ファンクション コール サ 
ポート 関数 





bdos 


ファンクション コールの 実行 (a の 値 を 返す） 


127 


bdosh 


ファンク ショ ン コールの 実行 (hi の 値 を 返す） 


\27 


bios 


BIOS コールの 実行 


129 


call 


機械語 プログラム を 呼ぶ (hi の 値 を 返す） 


130 


calla 


機械語 プロ グラム を 呼ぶ (a の 値 を 返す） 


133 


callxx 


機械語 プログラム を 呼ぶ (結果 を 得る） 


131 



9.8 メモリ 操作 鹏 





メモリ ブロックの 転送 


198 


memcpy 


memset 


メモリ ブロック に 値 を 書き込む 


199 


movmem 


メモリ ブロックの 転送 


203 


setmcm 


メ モ リ プロ ッ ク に倘を 書き込む 


22H 
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9.9 汎用 讕数 





絶対値 ゃ扳す 


123 


getenv 


環境 変数の 値 を 得る 


175 


longjmp 


関数 間の 直接 ジャンプ 


195 


max 


2 つの 引数のう ち， 大きい 方 を 返す 


197 


min 


2 つの 引数のう ち， 小さい 方 を 返す 


201 


putenv 


環境 変数の 値 を 設定す る 


211 


qsort 


ソートの 実行 


213 


rename 


ファイル 名の 変更 


216 


setjmp 


関数 間の 直接 ジャンプ 


226 


unlink 


ファイルの 削除 


254 
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付錄 A サンプル プログラム 
"q, com" について 



1Q.1 "q,com" と は 

システム ディ スクに 含まれて いる サンプル プログラム q.com は， 直線が 任意に 色 を 変えながら 
図形 を 描き， も う一 方の 直線が それ を 消して いく という プログラムです. マシンが MSX の 場合 は 
自動的に MSX 用 （スクリーンモード 2) 力、 MSX2 の 場合 は MSX2 用 （スクリーンモード 8) 
が 動作し ます. 

MSX^DOS 上で 

A>q@ 

と タイプす ると 動作し ます. 

動作して いると きに 任意の キー を 押す と MSX-DOS に 戻ります. もし， 動作して いると きに 
Ctrl + STOP を タイプして しまつ た 場合 は リ セ ッ ト を かけて 下さ い. 

q.com は q.c を コンパイル， アセンブル する ことによって できた q.rel と， 直線 を 指定した 色で 
描く ための ライブラリ line.rel, ランダムな 整数 を 返す ライブラリ rnd.rel, BASIC の ROM 内ル 
一 チン を 用いる ための ライブラリ calbas.rel と 標準 ライブラリ と を nikq.bat という バッチ ファ 
ィ ルを 使つ て リンクす る ことによ つ て 生成す る こ とがで き ま す. 

10.2 a com 内の 園 数 を 利用す るに は 

q.com で 用いられた line ( ) ， rnd () などの 関数 は 他の プログラムで 用いる こと もで きます 力、 
そ の 場合 は 次の よ う な 作業 を 必要 とします. 

10.2,1 B 数の 重 雷 

各 関数 を 使う プログラム では， 必ず 以下のような 宣言 をし なければ なりません. （これら は 

stdio.h では 宣言され ており ません.） 

VOID lineO; 
VOID chgvodO; 
VOID totextO; 
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第 10 車 サンプル プログラム "q， com" について 



VOID cls(); 
TINY *color(); 
unsigned rnd(); 



io,e,g リンク 

リ ンクを 行う 場合， rnd () 以外の 関数 を 使用す るに は 必ず ca lbas,rel を リンクし なければ なり 
ません. さらに， line (), color () を 使用す るに は C albas.rd より 前に line.rel, color.rel を リン 
ク しなければ なりません. md () を 単独で 用いる 場合 は rnd.rel のみ を リ ンク して 下さい. 



「例， 

rnd (), color () を 使わない 場合の リ ンク例 は 次のようになります. 
1 80 ck.progm, line ( calbas,clib/s,cr un/s • cend , proga/n/y/e : x 雇 a i n 

IO-g-3 acom 内の M 数の 仕様に ついて 

q.com の 中で 使われて いる 関数の 仕様に ついて 説明し ます. 他の プログラムで これらの 関数 を 
用いる 場合に ご 参照 下さい. 

ぐ line > 

VOID line(xl, yl, x2, y2， color, log 一 op) 

int xl, yl， x2, y2 ； 

TINY color, log 一 op ； 

座標 (xl,yl)， 座標 <x2，y2) を 結ぶ 直線 を color で 指定した 色 を 描きます. MSX2 の 場合に は 
BASIC と 同様な ロジカル オペレーションが 使えます が， MSX1 の 場合 は 使えません. ですから 
MSX1 の 場合 や， ロジカル オペレーション を 使わない 場合に は， log— op に は (TINY) 0 などの ダ 
ミ〜 の 値 を 入れて 下さい， 

座標の 指定で きる 範囲 はス クリーン モードに よって 異なります. スクリーンモード は 次に 説明 
す る chgmod ( ) で 変更す る こと がで きます. 



「例 1 

iine(x,y,xl.yl.c,(TINY)0); 

^chgmod> 

VOID chgmod(mod) 
TINY mod ； 
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スクリーンモード を mod で 指定 した モードに 変更し ます. mod に は 0 から 8 ま での 整数が 有 
効で （MSX1 の 場合 は 0 から 3), それ 以外の 値 を 与える と 何の 動作 も 行いません. 



※スクリーン モードに ついては BASIC マニュアルの screen 文の 説明 を 参照して 下さい. 

ぐ totext> 

VOID totext ( ) 

スクリーンモード を 元の （1 番 最後の） テキスト モードに 戻します. ですから， テキスト モード 
の 状態で これ を 実行しても 何の 動作 も 行いません. 引数， 戻り 値はありません. 

<cls> 

VOID els ( ) 

画面 をク リアし ます. 
く color 〉 

TINY *color(fore, back, bord) 
TINY fore, back, bord ； 

フォア グランド， ノ 《ック グランド， ボーダーの 色 を 指定し ます. 

戻り 値と して 直前の 設定 を 格納した 3 バイ トの エリアへの ボイ ンタが 返されます. 

TINY *preV, O previous color 

chgnod(8) ； 

prev = color(255, 0, 0); O スクリーン 8 で フォア を 白， 

ノ s ック， ボ- ダーを 黒に 指定 

color(prevC0], prevCl], prevC2]; O 設定 を 元に 戻す 



<rnd> 

unsigned rnd grange) 
unsigned range ； 

0 から （range - 1) までの ランダムな 整数 を 返します. 引数， 戻り 値はありません. 
こ の 関数 は rnd.mac で 定義され てい ま す. 
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第 10 章 サンプル プログラム "q. com" について 



10.2.4 ffl 速 書籍の 紹介 



現在 MSX-DOS, C 言語 関連の 書籍と して は 次の ような ものが 出版され ています. q.com のよ 
うな プログラム を 作成す るのに 大変 参考になります ので， ぜひ ご 参照 下さい. 



MSX テクニカル データ ブック 1 
MSX テクニカル データ ブック 2 
MSX2 テクニカル ハンドブック 
V9938 テクニカル データ ブック 

C 言語 入門 

入門 C 言語 
実習 C 言語 
応用 C 言語 

プログラミング 言語 C 



アスキー • マイクロ ソフト FE 本部 編著 
アスキー • マイクロ ソフト 編著 
アスキー • マイク ロソフ 卜 FE 監修 
アスキー • マイク ロソフ ト FE 本部 ノ 日本 楽 
器 製造 株式会社 編 

Les Hancock-Morris Krieger 共有 
アスキー 出版 局 監訳 
三 田 典玄著 
三 田 典玄著 
三 田 典玄著 

以上 株式会社 アスキー 
B.W. カーニハン 'D.M. リ ツチ 一 著 

共立 出版 株式会社 
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付録 B MSX-C Ver.l.S 
マス ターティス ク 内容 



マスタ一 ディスクに は 以下の フ アイ ルが含 まれて います. ご 確認 下 さい. 



¥ (コマンド， ライブラリが 含まれて います.） 



cf.com 


コンパイラ （バーサ） 


cg.com 


コンパイラ （コード ジェネレータ） 


fpc.com 


ファンク ショ ン パラメータ チェッカ 


mx.com 


モジュール 抽出 ュ一 ティ リ ティ 


ck.rel 


カーネル 呼び出し ルーチン 


clib.rel 


標準 ライブラリ （カーネル 本体 を 含む) 


crun.rel 


実行時 ルーチン 


cend.rel 


標準 ライブラリ 


lib.tco 


FPC 用 標準 ラ ィ ブラ リ. tco フ アイ ル 


c.bat 


コ ン バイ ル用バ ツチ ファイル 


readme.doc 


あれば 最新の 情報が 入って います. 



¥include (ヘッダ フ アイ ルが含 まれて います.） 



baosfunc.h 


MSX DOS ファンクション コール 用 ヘッダ 


conio.h 


キーボード *IZ0 関数 用 ヘッダ 


ctype.h 


文字 種 判断 関数 用 ヘッダ 


direct.h 


ディ レク ト リ 操作 関数 用 ヘッダ 


io.h 


低水準 入出力 関数 用 ヘッダ 


malloc.h 


メモリ 管理 関数 用 ヘッダ 


memory .h 


メモリ 操作 関数 用 ヘッダ 


process, h 


プログラム 操作 関数 用 ヘッダ 


setjmp.h 


setjnip 用へ ッ タ 


stdio.h 


高水準 入出力 関数 用 ヘッダ 


stdlib.h 


汎用 関数 用 ヘッダ 


string.h 


文字列 操作 関数 用 ヘッダ 


type.h 


MSX-C 標準型の 定義 用へ ッ ダ 
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MSX-C Ver.1.2 マスター ディスク 内容 
¥batch (ライブラリ 再 作成 と 開発 環境の 作成 用バ ッ チが含 まれて います.） 



arel.oat 


MX 用 スケルトン ファイル （アセンブリ 言語 用） 


crel.bat 


Ma 用スグ ノレ 卜ノ/ アイ ノレ （し 曰 go/i3j 


cenv.oat 


MSX-C 用 の 環境 変数 を 整え る バッチ ファイル 


forremk.bat 


この ディスク を 作成す るた めの バッチ ファイル 


genlib.bat 


標準 ライブラリ 再 作成 開始 用パ ツチ ファイル 


genliba.bat 


アセンブリ 言語 用 再 作成 バ ツチ ファイル 


genlibc.bat 


C 言語 用 再 作成 バッチ ファイル 


genrel.bat 


ライブラリ .rel フ アイ ル再 作成 用 バッチ フ アイ ル 


gentco.bat 


ライブラリ. tco フ アイ ル再 作成 用バ ツチ ファイル 


mksys.bat 


MSX-C の ディスク 作成 用バ ツチ ファイル 



¥src (標準 ライブラリの ソース フ アイ ルが含 まれて います.） 



clibc.c clibmac.mac のス ケルト ン作成 用 ファイル 

direct.c ディ レク ト リ 操作 関数 ソースファイル 

iox 低水準 入出力， キーボード 関数 ソースファイル 

malioc.c メモリ 管理 関数 ソース フ アイ ル 

process.c プロ ダラ ム 管理 関数 ソースファイル 

stdio.c 高水準 入出力 関数 ソース フ アイ ル 

stdlib.c 汎用 関数 ソースファイル 

stringx 文字列 操作 関数 ソースファイル 



ck.mac 力 一 ネル 呼び出 し ルー チ ン ソ ース ファイル 

clibmac.mac 標準 ライ ブラ リ 関数 アセンブラ 記述 部 

crun.mac 実行時 ルー チン ソースファイル 

cend.mac 標準 ライ ブラ リ 関数 アセンブラ 記述 部 2 
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¥sample (MSX-C を 使った サンプルが 含まれて います.） 



head.c フ アイ ルの 先頭 を 表示す る フィルタ コマンド 

wcc ファイルの 行数， 単語 数， バイ ト 数の 表示 

q.com グラフ ィ ッ ク 表示 

q.c q.com ソース 

line.c line () 関数 ソース 
line.re! ノノ オブジェクト 

color.c color v ； 関数 ソース 
color.rel ノノ オブジェクト 

calbio.mac calbio ( ) 関数 ソース 
calbio.rel " オブジェクト 

rnd.mac rnd ( ) 閼数 ソース 
rnd.rel " オブジェクト 

mkq.bat q.com 作成 用バ ツチ ファイル 

searchx Disk-BASIC 環境での 使用例 

search.bas Disk-BASIC 側の プログラム 

search.bat コンパ ィ ル から 実行 ま で 行う バ ツチ ファイル 

bk.mac 

romO . mac ROM 化 プログラム サンプル 
roml .c 



以上 64 ファイル + readme.doc 
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索 引 



索 引 

【記号】 

# include 47,61 ，76、78,79 

i pragma 21,40,41,42 

.com ファイル 20,38 

.rel ファイル 91,93,94 

【B】 

BOOL m 21,58, 72， 75,83,208 

【c】 

CF 33,36,47,59,64, 78,257,261 

CG 36,37,59, 64,65,258,275 

charconst 42,43 

CPU 11,16,62,88,92,】 11 

【E】 

EOF 82MM5J63J70 

【I】 

intconst 42,43 

I/O ポ— 80, J 78, 206 

I/O リ ダイ レ クシ ヨン 21 

【门 

L-80 26,39 

【M】 

MSX-DOS 63,66,84,131 

M-80 113 

【N】 

nonrec 21,40,41,42,45,50,112 

NULL 13 t I4 f 52,74,83 

【o】 

optimize 40,46 

【Pl 

PDP-11 40,42,43,54,55,56,57 

【R】 

recursive 40,41,120,269 

register 11,12,44 

KOM • 108J15,U6,120 

【s】 

stdin 14,22,82,84,86,91 

stdio.h 21,47,48,59,61,66, 72、 74， 76, 

77,79,82,84,122 

【T】 

T-code 11 

【u】 

UNIX 13,14,20,40,60,61,84,90 



V7 UNIX-C 40 

【V】 

VOID 型 21,75,83 

【ァ】 

アーギュメント 13 

アセンブラ… 15,16 ュ S^G^IS&S^S?, 59,60,65,73, 

95,100,130 

アンダー フロー 42 

【ヱ】 

エディ タ 15,17,19,98 

エラ 一メッセージ 28,30,31, 34,35,37,94, 

261,275,277,279 

【才】 

オーバ一 フロー 29,30,42,220,268， 

269,271,272 

オブジェ ク ト 1 1 、16,40，41 ,42,44,46.47,94 

オプション スィ ツチ 20 

オプティマイズ 44,46 

【力】 

力一 二 ハン 291 

拡張 子 15,25,26,34,36,64,93 

赚換 30,42,52,257 

可変 パラ メータ 47，48,49,50,54,55,56、58,62 

関係 演算 42 

【キ】 

記憶 クラス 44, 120,264,267 

キャスト 42,48,52,61,63,208,209. 

261 f 264 t 271 

キャラクタ 62,276,283 

【グ】 

グローバル シンボル 36,60,258 

【3】 

コード • セ グメン 1 120 

コード ジヱネ レー タ 11,12, 18.2Z36.40, 

44,59,104,258, 

固定 バラ メータ ヰァ，化^ぇら令らら，ら今ュ仂 

コメント 27,28、64,257,274 

【サ】 

再帰 モード 12,40,41,296 
サンプル プログラム 9.10.17,20,115, 120,288 

【シ】 

識別子 23,31,47,48,51,59 

シンボル 29,36,37,60, 77,258 
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実行可能 プログラム 16 

【ス】 

スタック 54,57,88 

【セ】 

整数 定数 42 

宣言 21,22,23,28ヌ2,47，48,49,51,63, 79、 

80 t 81 t 8Z83 f 84J19 

【ソ】 

ソース フ アイ ル… 11 15,21,26,29,30, 60, 1 13 

ソース プログラム 11,26,30， 109 

【タ】 

タイマ 割り込み 119 

【チ】 

中間 言語 フ アイ ル 11,15.27,32，36、93 

抽象 宵 言 子 47,48,26L267 

【ッ】 

ツール 9,20,93,260 

【テ】 

定義 21,22,32,33,34,35,47,63 

デバッグ 238 

デフォルト • 40A2 t 55,56 

【ネ】 

ネスト 27,89,226,257,269 

【ハ】 

ハッシュ 29,268 

ハンド アセンブル 15,16 

バイ ト 12 f 37,54, 62, 63, 67, 74, 89, 2 09 

バイ ト 算術 演算 42 

バッチ ファイル 25,30 

んサ 26/257 

パイ プライ ン 20,21,84 

パラメータ チェ ック 92,101 

【ヒ】 

非 再帰 モード 12,4 鎖 



標準 カーネル 13,22,38,66,115 

標準 ライブラリ 関数 48,76, 79,84, 122,281 

【フ】 

フロントエンド li、67 

分割 コンパイル 30,33 

プール 29,271 

プリ プロ セ ッサ 21, 40.41 ,42 A3 A6 

【へ】 

ヘッダ ファイル 22,27, 76, 78, 79 

【ホ】 

ポィ ンタ 2130,34,35.50,52,259 

【マ】 

マシン 語 10,15 ュ 6,107,108.109,114 

【モ】 

t 字魏 42 

【3】 

予約語 41,51,264 

【ラ】 

ライブラリ 48, 76, 79,84,122,281 

【ヮ】 

リ ロケータ ブル オブジェ ク ト 16 

リンク 16,38，54,59,94，95，97，109 

【レ】 

レジスタ 割付 11, 12,40,44,46 

【a】 

ロード 16J07J09J13J14J15 

論 麵» 4Z51 

【ヮ】 

ワーク 用 テーブル 29,257 

ワード 42 

割り込み 処理 "9， 120 
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お^い 合わせに ついて 

お問い合わせに ついて 

弊社で は 厳重に 梱包した 上， 細心の 注意 を 払って 製品 を 発送して おります. 万一， 輸送 上の ト 
ラ ブルが 起 こ つ た 場合 に は ご 一報い ただければ 新しい ものと 交換いた します. 

マニュアル 作成に あたり， なるべく 詳細な 説明 をす るよう に 心がけた つもりで すが， 理解で き 
ない ところ は 実際に コンピュータと 向きあって 納得の いくまで 確かめて 下さい， また， 他の ぺ一 
ジを 参照す るの も ひとつの 方法です. それでも 疑問 点が 解決で きないと き は， 購入され た 販売店 

に 問い合わせ るか， ㈱アスキー ユーザー サポート （直通電話 03-498-0299) までお 電話いた だけ 
れば， 係が お答えし ます. しかしながら， 回線が 混み合い ご迷惑 を かける こと もあります ので， 
なるべくお 手紙に てお 願いいた します. その 際に は， 下記の 要領で 記入して 下さい. 記入され て 
ない 項目が 一つで もあります と， 回答で きかね る 場合が あります. 十分 注意して 下さい. 
また， 本 製品 以外に 対しての ご 意見， ご 希望が ございましたら， 弊社まで およせく ださい. 

記 

1. 送付先 〒 107-24 東京都 港 区 南 青山 6-11-1 ス リー エフ 南 青山 ビル 

株式会社 アスキー ユーザー サポート 係 
TEL 03-498-0299 

(祝祭日 を 除く 月 〜金曜日， 10:00〜12:00， 13:00〜17:00) 

2. 必要 項目 

(1) お客様の 氏名， 住所 (郵便番号)， 電話番号 (市外 局番 も 含む） 

(2) 製品 名， 製品 シリアル 番号 

(3) 機器 構成 

本体 装置 名， メモリ バイ ト数 

CRT 装置 名， フロッピーディスク 装置 名 

プリンタ 装置 名 

その他 I/O, I/F 装置 名 

(4) お問い合わせ 内容 

お問い合わせの 内容 は， できるだけ 製品の マニュアルに 記述され ている 用語 を 用いて， 具 
体 的 かつ 明確に 記述して ください. なお， 障害と 思われる 現象に ついては， その 現象 を 再現 
可能な 情報が 必要です • 当社で 再現で きない もの は， 調査が できません. その 現象が 発生す 
るまでの 操作 手順， データ を 必ず 添付して 下さい. データ ディスクが ある 場合 は， その コピ 
一 も 同封して いただく と 調査が スピーディ 一になります. 

また， お客様 固有と 思われる アプリケーションの 設計， 作成， 運用， 保守に ついては， 当 
社の サポート 範 H 外です ので， お問い合わせいた だいても 回答で きません. ご了承 下さい ま 
すよう お願いい たします. 
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「MSX-C Ver.l.2」 ユーザ— ズ マニュアル 正誤表 

1989 年 4 月 14 日 
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第 11 章 MSX - C Ver.1.2 マスター ディ ス 


付錄 B MSX - C Ver.1.2 マスター デ イス 






ク 内容 


ク 内容 


P.29 


下から 2 行 目 


symbol table く 使用 バイ ト数 


symbol table く 使用 バイ ト 数〉 








• 


P.35 


8 


...sorry can"t check … 


...sorry can't check ••• 


P.37 


2 


中間 言語 ファイル を 出力し ます 


アセンブラ ファイル を 出力し ます 


P.69 


下から 2 行 目 


¥CHKCHR(5DH) 


XHKCHR(5DH) 


P.107 


3 


図 6-1 


図 5-1 


P.107 


最下 行 


100 CLEAR ，& HCFFF 


100 CLEAR 300,&HCFFF 


P.108 


2 


(新しい HIMEM — 1) 


(新しい HIMEM - 1) 


P.108 


5 


図 6-1 


図 5-1 


P.108 


下から 6 行 目 


100 CLEAR ，& HCFFF 


100 CLEAR 300,&HCFFF 
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例 



#in include <stdio.h> 

卜 l % 文字列 s 中の AM の 小文字 を 大文字に する （漢字 対応版） xl 

cha char *jstrupr(s) 

cha char * s ; 

{ { u 

char «head = s; 

char c; 

while (c = *s) { 

if (iskanjl(c)) /* 1 バイト 翻べ る */ 

/* 漠字 なので そのまま 1 バイト 進める */ 
S++; 

else 

»s = toupper(c);/* ANK は 必要なら 大文字 変換 
) s++; 1% 次の 文字 を 指す ようにす る 

return (head); 



正 



例 



ff include <stdio.h> 

A 文字列 s 中の ANK の 小文字 を 大文字に する （漢字 対応版） */ 
char *jstrupr(s) 
char お; 
{ 



char 
char 



*head = sj 

0； 



while (c = *s) { 

if (iskanji(c)) /* 1 バイト 調べる */ 

/* 漠字 なので そのまま 1 バイト 進める */ 
S++; 

else 

*s = toupper(c);/* ANK は 必要なら 大文字 変換 
} /* 次の 文字 を 指す ようにす る 

return (head); 



